Prueba 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 que puedas probarla y ofrecerla a tus usuarios durante un tiempo limitado. Una vez que se completa la prueba y se evalúan los comentarios, Chrome decide si la función debe estar disponible para todos.
Puedes registrarte en una prueba de origen para habilitar una función para todos los usuarios de tu origen sin que tengan que activar ninguna marca o cambiar a una compilación alternativa de Chrome (aunque es posible que deban actualizar). Una vez registrados, los desarrolladores pueden crear demostraciones y prototipos con las 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.
Disponibilidad
Las pruebas de origen 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 estar dispuestos a trabajar de forma relativamente independiente con la documentación disponible, que, en esta etapa, probablemente se limite a las especificaciones y explicaciones de la API. Intentamos brindar orientación siempre que sea posible.
Si te registras en 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 varias pruebas de origen, ya que se incorporan 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 en el registro. Esto permite que los proveedores de contenido o servicios incorporados prueben una función nueva en varios sitios sin necesidad de un token para cada origen.
Obtén más información en ¿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 conocen como pruebas de origen "inversas".
Por ejemplo, se quitaron los eventos de mutación, a partir de Chrome 127. Los sitios que necesitaban tiempo adicional antes de quitar estos eventos pueden registrarse en la prueba de baja para volver a habilitar los eventos de forma temporal en sitios especificados.
Participa en una prueba de origen
- Elige una prueba de origen de la lista de pruebas activas trials.
- 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 deseas habilitar la función de prueba:
- Como una metaetiqueta en el <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 una metaetiqueta en el <head>:
- Prueba la función nueva.
- Envía comentarios. Para ello, usa el 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 recibir comentarios espontáneos de la comunidad. Por lo general, esto apunta a la función en GitHub o en algún otro canal público.
- Cuando venza tu token, recibirás un correo electrónico con un vínculo de renovación. Para ello, se te pedirá que vuelvas a enviar comentarios.
Puedes registrarte en la misma prueba de origen varias veces para diferentes orígenes y agregar varios tokens en la misma página. Esto puede ser útil si necesitas proporcionar tokens que sean válidos para los recursos que se publican desde diferentes orígenes, como el código incluido en varios sitios que posees.
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 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 elementos iframe
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,
ventana emergente,
panel lateral o
documento fuera de la pantalla, usa la
trial_tokens clave en tu archivo
manifest.json.
"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]
Las secuencias de comandos de contenido se manejan
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:
- Inserta un encabezado con
declarativeNetRequest - Agrégalo 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 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 en una prueba, usa la URL chrome-extension://YOUR_EXTENSION_ID, por ejemplo, chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.
Renueva la inscripción a la prueba de origen
Si se extiende una prueba de origen, recibirás un correo electrónico de advertencia en el que se te indicará que debes renovar el registro y proporcionar un token nuevo para cada origen inscrito en la prueba.
- Ve a Mis registros.
- Para cada origen registrado para la prueba extendida, haz clic en RENOVAR.
- Copia el token nuevo y hazlo disponible para cada página que deba permanecer inscrita en la prueba. Puedes proporcionar varios tokens si es necesario.
Chrome ignora los tokens no válidos o vencidos.
Consulta la información de la prueba de origen
Consulta la información sobre las pruebas de origen disponibles para un sitio desde el panel Application de las Herramientas para desarrolladores de Chrome.
Funciones en la prueba de origen
A continuación, se muestran demostraciones de las APIs en las pruebas de origen en curso.
Recursos
Sigue leyendo nuestra documentación conceptual de Chrome:
Descubre más sobre las pruebas de origen en Chrome:
- Guía para desarrolladores web
- Explicación de la prueba de origen
- Cómo ejecutar una prueba de origen
- Proceso para lanzar funciones nuevas en Chromium
- Intención de explicar: Desmitificación del proceso de envío de Blink
- Consulta la información de las pruebas de origen en las Herramientas para desarrolladores desde Chrome 94
Otros navegadores
Encuentra pruebas de origen en otros navegadores: