Cómo comenzar con las pruebas de origen

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 por 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 en tu origen, sin que tengan que activar o desactivar ningún parámetro de configuración ni cambiar a una compilación alternativa de Chrome (aunque es posible que deban actualizarlo). Una vez registrados, los desarrolladores pueden crear demostraciones 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 origen son públicas y están abiertas a 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 y ser capaces 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 proporcionar orientación siempre que sea posible.

Si te registras para una prueba, el equipo de Chrome te pedirá periódicamente comentarios específicos sobre tu uso de la función de prueba. Algunas funciones pueden someterse 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: ¿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. Estas se conocen como pruebas de baja. En algunos contextos, se las denomina pruebas de origen "inversas".

Por ejemplo, se quitaron los eventos de mutación, a partir de Chrome 127. Los sitios que necesitaban más tiempo antes de quitar estos eventos pueden registrarse en la prueba de baja para volver a habilitar los eventos de forma temporal 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 en la que quieras habilitar la función de prueba:
  4. Prueba la nueva función.
  5. Envía comentarios. Para ello, 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 del equipo de Chrome. Cada prueba también proporciona un vínculo para recibir comentarios espontáneos de la comunidad. Por lo general, esto dirige a la función en GitHub o algún otro canal público.
  6. 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, además, incluir varios tokens en la misma página. Esto puede ser útil si necesitas proporcionar tokens que sean válidos para los recursos que se entregan desde diferentes orígenes, como el 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 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 e iframes

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 al uso de todos los 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 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.

Renueva la inscripción en 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.

  1. Ve a Mis registros.
  2. En cada origen registrado para la prueba extendida, haz clic en RENOVAR. Ejemplo de la página Mis registros, con los botones RENOVAR
  3. Copia el token nuevo y haz que esté 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.

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 Aplicación de las Herramientas para desarrolladores de Chrome.

Vista de detalles del marco del panel Aplicación 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 sobre los conceptos de Chrome:

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

Otros navegadores

Encuentra pruebas de origen en otros navegadores: