Probar una función nueva o experimental de la plataforma web
Las pruebas de origen te dan acceso a una función nueva o experimental para crear una funcionalidad que tus usuarios puedan probar por un tiempo limitado antes de que esté disponible para todos.
Cuando Chrome ofrece una prueba de origen para una función, puedes registrarte en la prueba para habilitarla para todos los usuarios de tu origen, sin que deban activar o desactivar ninguna marca ni cambiar a una compilación alternativa de Chrome (aunque es posible que deban actualizar). Las pruebas de origen permiten a los desarrolladores compilar demostraciones y prototipos con funciones nuevas. 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.
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, probablemente se limitará a las especificaciones y explicaciones de la API, aunque intentemos 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
Por lo general, las pruebas de origen solo están disponibles que realizan los datos de origen: 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 requerir un token para cada origen.
Más información: ¿Qué son las pruebas de origen de terceros?
Pruebas de baja
No todas las pruebas de origen se utilizan para probar nuevas APIs. Algunas pruebas permiten que se vuelva a habilitar temporalmente una función obsoleta. Se conocen como pruebas de baja y, en algunos contextos, se las denomina pruebas de origen "inversas".
Por ejemplo, a partir de Chrome 85, AppCache ya no está disponible en Chrome de forma predeterminada. Los sitios que necesiten más tiempo para migrar de AppCache pueden registrarse en la prueba de baja para seguir usando AppCache hasta Chrome 93.
Participa en una prueba de origen
- Elige una prueba de origen de la lista de pruebas activas.
- Para solicitar un token, haz clic en el botón Registrarse y completa el formulario.
- Proporciona el token en cada página web para la que desees que se habilite la función de prueba:
- Como metaetiqueta en la etiqueta <head>:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
- Como un encabezado HTTP:
Origin-Trial: TOKEN_GOES_HERE
- Proporcionando un token de manera programática
- Como metaetiqueta en la etiqueta <head>:
- Probar la nueva función
- Envía comentarios. Para hacerlo, usa el sitio de la prueba de origen. Estos comentarios no son públicos y solo están disponibles para un grupo limitado de personas en el 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.
- 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, además, 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 forma programática.
En cuanto a todo el uso del token, 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 manejan de manera 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 declarativeNetRequest o de forma programática directamente en tu secuencia de comandos de contenido. Recuerda que los tokens están vinculados a dominios específicos, por lo que te recomendamos que registres uno para el dominio en el que se ejecuta la secuencia de comandos de contenido, en lugar de tu ID de extensión.
Si deseas 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 una advertencia por correo electrónico en la que se indicará que debes renovar el registro y proporcionar un token nuevo por cada origen inscrito en la prueba.
Navega a la página Mis registros.
En cada origen registrado para la prueba extendida, haz clic en el botón RENOVAR.
Copia el token nuevo y hazlo disponible para todas las páginas que deban permanecer inscritas en la prueba. Puedes proporcionar varios tokens si es necesario: Chrome ignorará 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 una página en el panel Application de Chrome DevTools.
También puedes usar nuestro decodificador de tokens de prueba de origen para ver los datos codificados en un token.
Demostraciones de pruebas de origen
- Token en una metaetiqueta
- Token en un encabezado
- Token inyectado por una secuencia de comandos de terceros
- Función a la que se accede en un iframe
- Ejemplos de iframes de origen cruzado
- Decodificador de tokens de prueba de origen
Más información
- Solución de problemas de las pruebas de origen de Chrome
- ¿Qué son las pruebas de origen de terceros?
- Guía de pruebas de origen para desarrolladores web
- Explicación de la prueba de origen
- Ejecuta una prueba de origen
- Proceso para lanzar nuevas funciones en Chromium
- Intent to explain: Demystifying the Blink Shipping Process
- Cómo ver la información de las pruebas de origen en DevTools
- Usa pruebas de origen en Microsoft Edge
- Pruebas de origen para Firefox