Cómo comenzar con las pruebas de origen

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

Sam Dutton

Las pruebas de origen te dan acceso a una función nueva o experimental, de modo que puedas probarla y ofrecértela a tus usuarios por un tiempo limitado. Una vez que se complete la prueba y se evalúen los comentarios, Chrome decidirá si la función debe estar disponible para todos.

Puedes registrarte para obtener una prueba de origen para habilitar una función para todos los usuarios de tu origen, sin que deban activar ninguna marca ni cambiar a una compilación alternativa de Chrome (aunque es posible que deban actualizar). Una vez que se registren, los desarrolladores podrán compilar demos y prototipos con las nuevas funciones. Las pruebas también ayudan a los ingenieros de Chrome a comprender cómo se usan las funciones nuevas y cómo pueden interactuar con otras tecnologías web.

Disponibilidad

Las pruebas de Origin son públicas y están disponibles para todos los desarrolladores. Tienen una duración y un uso limitados. La participación es un proceso autoadministrado con documentación y asistencia limitadas. Los participantes deben tener la voluntad y la capacidad de trabajar de forma relativamente independiente con la documentación disponible, que, en esta etapa, es probable que se limite a las especificaciones y explicaciones de la API. Intentamos brindar orientación siempre que sea posible.

Si te registras para una prueba, el equipo de Chrome te pedirá periódicamente comentarios específicos sobre el uso de la función de prueba. Es posible que algunas funciones se sometan a varios ensayos de origen a medida 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

De forma predeterminada, una función de prueba de origen solo está disponible en el origen registrado para la prueba. Algunas pruebas proporcionan una opción de coincidencia de terceros durante el registro. Esto permite que los proveedores de contenido o servicios incorporados prueben una función nueva en varios sitios sin requerir un token para cada origen.

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

Pruebas de baja

Algunas pruebas de origen te permiten volver a habilitar temporalmente una función obsoleta. Se conocen como pruebas de baja. En algunos contextos, se los conoce como pruebas de origen "reversas".

Por ejemplo, se quitaron los eventos de mutación a partir de Chrome 127. Los sitios que necesiten tiempo adicional antes de quitar estos eventos pueden registrarse en la prueba de baja para volver a habilitarlos temporalmente en sitios específicos.

Participa 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 Registrarse 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. Probar la nueva función
  5. Envía comentarios. Hazlo 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 personas del equipo de Chrome. Cada prueba también proporciona un vínculo para los comentarios espontáneos de la comunidad. Por lo general, dirige a la función en GitHub o 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 solicitar que envíes comentarios.

Puedes registrarte en la misma prueba de origen varias veces, para diferentes orígenes, y también incluir varios tokens en la misma página. Esto puede ser útil si necesitas proporcionar tokens válidos para recursos que se entregan desde diferentes orígenes, como el código incluido en varios sitios que te pertenecen.

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 un encabezado HTTP o como una metaetiqueta en el código HTML de tu 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.

Tokens y iframes

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

En el caso de 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, un panel lateral o un documento fuera de la pantalla, usa la clave trial_tokens en tu archivo manifest.json.

"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]

Las secuencias de comandos de contenido se controlan de manera diferente. Exponer una función a un mundo podría ser confuso y poco intuitivo. En lugar de usar el trial_token del manifiesto, agrega el token a la página de una de las siguientes maneras:

Recuerda que los tokens están vinculados a dominios específicos, por lo que debes registrarte en el dominio en el que se ejecuta la secuencia de comandos de contenido, en lugar de tu ID de extensión.

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

Cómo renovar la inscripción en la prueba de origen

Si se extiende una prueba de origen, recibirás un correo electrónico en el que se te advertirá que debes realizar la renovación del registro y proporcionar un token nuevo para cada origen inscrito en la prueba.

  1. Ve a Mis registros.
  2. Para cada origen registrado en la prueba extendida, haz clic en RENOVAR. Ejemplo de la página Mis registros, con botones para RENOVAR
  3. Copia el token nuevo y hazlo disponible para todas las páginas que deban permanecer inscritas en la prueba. Si es necesario, puedes proporcionar varios tokens.

Chrome ignora los tokens no válidos o vencidos.

Cómo ver la información de la prueba de origen

Consulta información sobre las pruebas de origen disponibles para un sitio en el panel Application de Chrome DevTools.

Vista de detalles del marco del panel de la aplicación de Chrome DevTools.

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

Herramienta de decodificación de pruebas de origen que muestra los valores de prueba de origen decodificados.

Demostraciones

En los siguientes sitios, se muestran ejemplos de implementación de tokens.

Cómo proporcionar un token de prueba de origen

Herramientas de prueba de origen

Funciones de la prueba de origen

A continuación, se muestran demostraciones de las APIs que se encuentran en pruebas de origen en curso.

Recursos

Sigue leyendo nuestra documentación de conceptos de Chrome:

Obtén más información sobre las pruebas de origen en Chrome:

Otros navegadores

Cómo encontrar pruebas de origen en otros navegadores: