Cómo comenzar con las pruebas de origen

Probar una función nueva o experimental para la plataforma web

Sam Dutton

Las pruebas de origen te brindan acceso a una función nueva o experimental para compilar una funcionalidad que tus usuarios puedan probar durante un tiempo limitado antes de que esté disponible para todos.

Cuando Chrome ofrece una prueba de origen para una función, puedes registrarte a fin de habilitar la función para todos los usuarios de tu origen, sin necesidad de que activen las marcas ni de que cambien a una compilación alternativa de Chrome (aunque es posible que deban actualizarla). Las pruebas de origen permiten a los desarrolladores crear demostraciones y prototipos mediante funciones nuevas. Las pruebas también ayudan a los ingenieros de Chrome a comprender cómo se usan las funciones nuevas y cómo estas pueden interactuar con otras tecnologías web.

Las pruebas de origen son públicas y están abiertas a todos los desarrolladores. Su duración y uso son limitados. La participación es un proceso autoadministrado con asistencia y documentación limitadas. Los participantes deben estar dispuestos y ser capaces de trabajar de manera relativamente independiente con la documentación disponible, que, en esta etapa, probablemente se limitará a las especificaciones y explicaciones de la API, aunque intentamos brindar orientación siempre que sea posible.

Si te registras para obtener una prueba, el equipo de Chrome te pedirá periódicamente comentarios específicos sobre el uso de la función de prueba. Algunas funciones pueden someterse a varias pruebas de origen, ya que se incorporan los comentarios y se realizan ajustes.

Las pruebas de origen también están disponibles para Firefox y Microsoft Edge.

Pruebas de origen de terceros

Por lo general, las pruebas de origen solo están disponibles mediante datos de origen propios: solo funcionan para un único origen registrado. Las pruebas de origen de terceros permiten que los proveedores de contenido incorporado prueben una función nueva en varios sitios sin necesidad de un token para cada origen.

Obtén más información: ¿Qué son las pruebas de origen de terceros?

Pruebas de baja

No todas las pruebas de origen son para probar APIs nuevas. Algunas pruebas permiten que una función obsoleta se vuelva a habilitar de forma temporal. Estas se conocen como pruebas de baja y, en algunos contextos, se denominan pruebas de origen “reversas”.

Por ejemplo, from Chrome 85 AppCache ya no está disponible en Chrome de forma predeterminada. Los sitios que necesitan tiempo adicional para migrar fuera de AppCache podrían registrarse en la prueba de baja para seguir usando AppCache hasta Chrome 93.

Cómo participar en una prueba de origen

  1. Elige una prueba de origen de la lista de pruebas activas.
  2. Para solicitar un token, haz clic en el botón Register y completa el formulario.
  3. Proporciona el token en cada página web para la que desees que se habilite la función de prueba:
  4. Prueba la nueva función.
  5. Envía comentarios. Haz esto a través del sitio de prueba de origen. Estos comentarios no son públicos y solo están disponibles para un grupo limitado de miembros del equipo de Chrome. Cada prueba también proporciona un vínculo para que la comunidad envíe comentarios espontáneos. Esto generalmente apunta a la función en GitHub o en algún otro canal público.
  6. Cuando venza el token, recibirás un correo electrónico con un vínculo de renovación. Para ello, se te vuelve a pedir que envíes comentarios.

Puedes registrarte para la misma prueba de origen varias veces para orígenes diferentes y, además, incluir varios tokens en la misma página. Esto puede ser útil si necesitas proporcionar tokens válidos para los recursos entregados desde distintos orígenes, como código incluido en varios sitios de tu propiedad.

El framework de pruebas de origen busca el primer token válido y, luego, ignora todos los demás tokens. Puedes validar esto con las Herramientas para desarrolladores de Chrome.

Proporciona un token de manera programática

En lugar de proporcionar un token como encabezado HTTP o metaetiqueta en el código HTML de la página, como se describió anteriormente, puedes insertar un token con JavaScript:

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

Usa este método si participas en una prueba de terceros.

iframes y tokens

Para acceder a una función de prueba desde un iframe, puedes proporcionar un token de prueba en una metaetiqueta, un encabezado HTTP o de manera programática.

En cuanto a todo el uso de tokens, el origen registrado para el token debe coincidir con el contexto de JavaScript que accede a la función de prueba: el origen de la página que incluye una secuencia de comandos intercalada o el src de un elemento <script> para JavaScript incluido desde un archivo externo.

Tokens y extensiones

Para usar una función de prueba dentro de una secuencia de comandos en segundo plano, una ventana emergente o un documento fuera de pantalla, agrega un trial_token a tu archivo manifest.json.

Las secuencias de comandos del contenido se manejan de forma diferente. Exponer un atributo a un mundo puede ser confuso y poco intuitivo. En lugar de usar el trial_token del manifiesto, agrega el token a la página insertando un encabezado con declaritiveNetRequest o de manera programática directamente en la secuencia de comandos del contenido. Recuerda que los tokens están vinculados a dominios específicos, por lo que te conviene registrar uno para el dominio en el que se ejecuta la secuencia de comandos del contenido, en lugar del ID de la extensión.

Para registrar tu extensión en una prueba, usa la URL chrome-extension://YOUR_EXTENSION_ID, por ejemplo chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.

Renovar la inscripción a la prueba de origen

Si se extiende una prueba de origen, recibirás una advertencia por correo electrónico en la que se indicará que debes renovar el registro y proporcionar un token nuevo para cada origen inscrito en la prueba.

  1. Navega a la página Mis registros.

  2. En cada origen registrado para la prueba extendida, haz clic en el botón RENOVAR.Captura de pantalla de la página Mis registros de la prueba de origen de Chrome, en la que se muestran los botones RENOVAR

  3. Copia el token nuevo y haz que esté disponible para todas las páginas que permanezcan inscritas en la prueba. Puedes proporcionar varios tokens si es necesario: Chrome ignorará los tokens no válidos o vencidos.

Ver información de la prueba de origen

Consulta la información sobre las pruebas de origen disponibles para una página desde el panel Aplicación en Herramientas para desarrolladores de Chrome.

Información de la prueba de origen para un sitio que se muestra en la vista de detalles del marco del panel **Aplicación** de las Herramientas para desarrolladores de Chrome.

También puedes usar nuestro decodificador de tokens de prueba de origen para ver los datos codificados en un token.

Herramienta de decodificador de pruebas de origen, que muestra valores de prueba de origen decodificados.

Demostraciones de prueba de origen

Más información