Cómo solucionar problemas relacionados con las pruebas de origen de Chrome

Soluciona problemas comunes con los tokens de prueba en las metaetiquetas, los encabezados y las secuencias de comandos.

Lista de tareas

Para solucionar los problemas relacionados con una prueba de origen, revisa cada uno de los siguientes problemas con los vínculos proporcionados.

¡Pruébalo!

En las siguientes demostraciones, se muestra cada una de las formas de proporcionar un token de prueba de origen y acceder a una función de prueba:

Usa las Herramientas para desarrolladores de Chrome para verificar los tokens

A partir de Chrome 93, DevTools proporciona información de la prueba de origen en el panel de la aplicación para el marco seleccionado.

Información de las pruebas de origen de Chrome DevTools en el panel Application

Expande el marco superior a fin de inspeccionar los tokens de prueba de origen disponibles para un submarco. Por ejemplo, en la página de demostración en ot-iframe.glitch.me, puedes ver que la página en el iframe proporciona un token.

Panel Application de Chrome DevTools, que muestra tokens de prueba de origen para la página en el iframe.

  • Estado del token: Indica si la página tiene un token válido. Ten en cuenta que, para algunas pruebas de origen, puede haber otros factores, como restricciones geográficas, que hacen que la función de prueba de origen no esté disponible, a pesar de la presencia de un token válido. En Códigos de estado de Chrome DevTools, se explica el significado de cada uno de los códigos de las pruebas de origen.
  • Origin: Es el origen web registrado para el token.
  • Fecha y hora de vencimiento: Es la fecha y hora de vencimiento máximas (más recientes) posibles para el token, que normalmente coincidirán con el final de la prueba. Esto no es lo mismo que la fecha de vencimiento del token que se muestra en Mis registros, que muestra durante cuánto tiempo es válido el token actualmente y si se puede extender.
  • Restricción de uso: Son los límites de uso que se pueden establecer para algunas pruebas.
  • Tercero: Indica si la coincidencia de terceros está habilitada para el token. Esta opción está disponible para algunas pruebas de origen, en las que se debe acceder a una función de prueba en varios sitios desde secuencias de comandos de terceros.
  • Match Sub-Domains: Indica si la coincidencia de subdominios está habilitada para el token. Esto permite que se pruebe una función de prueba de origen en varios subdominios de un origen, sin requerir un token diferente para cada subdominio.

Las Herramientas para desarrolladores de Chrome mostrarán una advertencia junto al nombre de la prueba si esta no está disponible para el usuario actual, si el token venció o si hay otras restricciones.

Información de las pruebas de origen de las Herramientas para desarrolladores de Chrome en el panel de la aplicación que muestra el token vencido

Códigos de estado de las Herramientas para desarrolladores de Chrome

  • Venció: El token pasó su fecha de vencimiento. Se deberá renovar el token para generar uno nuevo con una fecha de vencimiento nueva.
    Código fuente

  • FeatureDisabled: la prueba está inhabilitada para usarla.
    Código fuente

  • FeatureDisabledForUser: Este token se designó como inhabilitado para el usuario actual a través de una restricción de uso alternativa. Consulta la sección "Exclusiones de subconjuntos de usuarios" del documento de diseño.
    Código fuente 1
    Código fuente 2

  • No seguro: El origen de la solicitud no es seguro y la prueba no está habilitada para orígenes no seguros. Como se explica en el código del validador de tokens de prueba de origen: “Para los tokens de terceros, tanto el origen actual como el origen de la secuencia de comandos deben ser seguros. Debido a la coincidencia de subdominios, es posible que el origen del token no sea una coincidencia exacta de uno de los orígenes de la secuencia de comandos proporcionada, y el resultado no indica qué origen específico se encontró. Esto significa que no es una búsqueda directa para encontrar el origen de la secuencia de comandos adecuada. Para evitar volver a hacer todas las comparaciones de origen, existen combinaciones de teclas que dependen de la cantidad de orígenes de secuencia de comandos que se proporcionaron. Debe haber al menos uno, o el token de terceros no se validará correctamente.
    Código fuente

  • InvalidSignature: El token tiene una firma no válida o con un formato incorrecto.
    Código fuente

  • Formato incorrecto: El token tiene un formato incorrecto y no se pudo analizar.
    Código fuente

  • NotSupported: La prueba de origen definida por el token no es compatible con el "incorporador" de Chromium: un navegador como Chrome o Edge, un WebView o algún otro usuario-agente.
    Código fuente

  • Correcto: El token tiene el formato correcto, no venció, coincide con una función de prueba de origen y se solicita desde un origen esperado.
    Código fuente

  • TokenDisabled: El token se marcó como inhabilitado y no se puede usar.
    Código fuente

  • TrialNotAllowed: La prueba de origen no está disponible para el usuario actual.
    Código fuente

  • UnknownTrial: El token especifica un nombre de función que no coincide con ninguna prueba conocida.
    Código fuente

  • WrongOrigin: El origen de la solicitud no coincide con el origen especificado en el token. Esto puede incluir el esquema, el nombre de host o el puerto. Este estado también se mostrará si se proporciona un token de terceros en un encabezado HTTP, una metaetiqueta o una secuencia de comandos intercalada, en lugar de un archivo JavaScript externo.
    Código fuente

  • WrongVersion: Versión del token incorrecta. Por el momento, solo se admiten las versiones 2 y 3 del token.
    Código fuente


No funciona. 🤔

Si la prueba de origen no funciona como se espera, asegúrate de cumplir con las siguientes condiciones.

Estás realizando pruebas en Chrome, no en Chromium ni en otro navegador.

Las pruebas de origen de Chrome están diseñadas para funcionar para los usuarios de Chrome. No confíes en los tokens de prueba de origen de Chrome para habilitar funciones de prueba en otros navegadores, incluidos Chromium y otros basados en Chromium. Esto se debe a que las pruebas de origen de Chrome son específicas de las funciones que se ponen a disposición de Chrome para la experimentación.

Las pruebas de origen también están disponibles para Firefox y Microsoft Edge. La inscripción en una prueba de origen de Firefox o Edge no habilitará una función en Chrome.

La prueba de origen está habilitada para las versiones de Chrome que acceden a tu sitio

El acceso a las pruebas se limita a versiones específicas de Chrome. En algunos casos, esto puede significar que una función de prueba solo está disponible para los canales de Chrome anteriores a la versión estable: Canary, Dev y Beta.

Puedes verificar la disponibilidad de las versiones en la página de registro de la prueba:

Página de pruebas de origen de Chrome para conjuntos propios y del mismo grupo con la disponibilidad de Chrome destacada

Puedes verificar la versión de Chrome que usas en chrome://version.

La configuración de Chrome no inhabilita la prueba de origen

Si un usuario informa que una función no funciona, verifica que no esté inhabilitada en la configuración de Chrome. Por ejemplo, las funciones de Privacy Sandbox se pueden inhabilitar desde la página chrome://settings/privacySandbox.

Las palabras clave y la sintaxis son correctas

Asegúrate de usar las palabras clave y la sintaxis adecuadas para los tokens de prueba de origen.

Para uso propio, se puede proporcionar un token en una metaetiqueta origin-trial:

<meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">

Como alternativa, se puede proporcionar un token en un encabezado de respuesta Origin-Trial. El siguiente es un ejemplo del uso de Express en Node.js:

app.use(function(req, res, next) {
  res.setHeader('Origin-Trial', 'Aj4DysCv3VjknU3...')
  next();
});

También se pueden proporcionar tokens mediante JavaScript:

function addTrialToken(tokenContents) {
  const tokenElement = document.createElement('meta');
  tokenElement.httpEquiv = 'origin-trial';
  tokenElement.content = tokenContents;
  document.head.appendChild(tokenElement);
}

El origen del token propio coincide con el origen de la página

Asegúrate de que el valor de Web Origin seleccionado cuando te registres en una prueba coincida con el origen de la página que tiene la metaetiqueta o el encabezado que proporciona el token.

Por ejemplo, si seleccionaste https://example.com como el origen web:

Página de pruebas de origen de Chrome que muestra https://example.com seleccionado como origen web.

Es posible que obtengas un valor de token como el siguiente:

En la página Pruebas de origen de Chrome,
se muestra el valor del token.

Verifica que este valor coincida con el token que se usa en la página para la que estás solucionando el problema.

Para ver un token proporcionado en una metaetiqueta, verifica el código HTML:

  <meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">

Para un token proporcionado en un encabezado, puedes verificar el valor del token desde el panel Network de Chrome DevTools en Response Headers:

Panel Network de Chrome DevTools que muestra el encabezado de respuesta de las pruebas de origen.

El token propio se entrega desde el origen que lo usa.

Para habilitar el acceso a una función de prueba de origen para el código incluido en una página que se entrega desde tu origen, proporciona un token de prueba en una metaetiqueta, un encabezado o a través de JavaScript desde el mismo origen.

El origen registrado para un token debe coincidir con el origen que lo entrega.

El origen del token de terceros coincide con el origen de la secuencia de comandos

Puedes registrarte para participar en una prueba de origen para secuencias de comandos que se insertan en otros orígenes.

Por ejemplo, si deseas que las secuencias de comandos que se entregan desde javascript-library.example participen en una prueba de origen, debes registrar un token con la coincidencia de terceros para javascript-library.example.

Página de registro de las pruebas de origen de Chrome que muestra la coincidencia de terceros seleccionada.

El valor de origen de un token de terceros debe coincidir con el origen de la secuencia de comandos que lo inserta.

La secuencia de comandos de terceros usa un token de terceros

No puedes habilitar una secuencia de comandos de terceros para que participe en una prueba de origen en tu sitio simplemente registrando un token para tu origen y no para la secuencia de comandos.

Las secuencias de comandos de terceros deben usar tokens con la coincidencia de terceros habilitada, que se insertan a través de la secuencia de comandos (no incluida en una metaetiqueta o un encabezado de tu sitio) con un código como el siguiente:

function addTrialToken(tokenContents) {
  const tokenElement = document.createElement('meta');
  tokenElement.httpEquiv = 'origin-trial';
  tokenElement.content = tokenContents;
  document.head.appendChild(tokenElement);
}

El token de terceros se proporciona a través de una secuencia de comandos externa, no de una metaetiqueta, un encabezado HTTP ni una secuencia de comandos intercalada.

Los tokens de terceros se validan en función del origen de la secuencia de comandos que los insertó, pero las secuencias de comandos intercaladas y las etiquetas <meta> en el marcado estático no tienen un origen (es decir, una URL de origen).

Esto significa que se debe proporcionar un token de terceros a través de una secuencia de comandos externa, no en una etiqueta <meta> ni en una secuencia de comandos intercalada. No importa si la secuencia de comandos externa que inserta el token proviene del mismo origen que la página que lo contiene o de un origen diferente, siempre y cuando el origen de la secuencia de comandos coincida con un origen registrado para la prueba.

Puedes ver una demostración de esto en ot-iframe-3p.glitch.me.

El acceso a la función de prueba de origen es compatible con el método que se usa para proporcionar un token de prueba.

Algunos tipos de acceso a las funciones de prueba de origen requieren que proporciones un token de prueba de una forma específica. Por ejemplo, la única forma de habilitar el acceso de prueba de origen para los trabajadores del servicio y los trabajadores compartidos es proporcionar un token en un encabezado Origin-Trial.

La coincidencia de subdominios está habilitada para un token que se usa en un subdominio

Si una función de prueba de origen no funciona en algunas páginas del sitio, comprueba que los tokens estén configurados correctamente para los subdominios que los entregan.

Cuando te registras para una prueba de origen, puedes elegir hacer coincidir todos los subdominios del origen de forma opcional:

Página de registro de las pruebas de origen de Chrome que muestra que se seleccionó la coincidencia de subdominios

También puedes hacer coincidir subdominios para tokens de terceros:

Página de registro de pruebas de origen de Chrome que muestra la coincidencia de terceros y de subdominio seleccionada

Los tokens de subdominio no se emitirán para los orígenes en la lista de sufijos públicos. Por ejemplo, no puedes registrar un origen como https://appspot.com o https://github.io, aunque puedes registrar dominios dentro de ese origen, como https://example.appspot.com o https://example.github.io.

El token sigue siendo válido

Los tokens son válidos durante seis semanas después de su creación. Más allá de eso, debes enviar comentarios para extender la fecha de validez. En la Guía de pruebas de origen para desarrolladores web, se explica cómo asegurarte de que tu token sea válido para una prueba de origen completa.

Puede verificar si hay tokens activos en la página Mi registros de las pruebas de origen de Chrome:

Pruebas de origen de Chrome 
La página Mi registros muestra Válido hasta la fecha

Las Herramientas para desarrolladores de Chrome muestran el estado Success si el token sigue siendo válido:

Información de las pruebas de origen de Chrome DevTools en el panel Application, que destaca el estado &quot;Success&quot;

Si tu token venció, DevTools mostrará el estado Expired y en la página Mis registros aparecerá una sección Tokens vencidos.

Pruebas de origen de Chrome 
Página Mis registros que muestra tokens vencidos.

La prueba de origen no finalizó

Puedes consultar la fecha de finalización de una prueba de origen en su página de registro:

Página de pruebas de origen de Chrome para First Party Sets y SameParty con los detalles de la prueba disponible destacados.

Para las pruebas que ya finalizaron, las Herramientas para desarrolladores mostrarán algo como lo siguiente:

La información de las pruebas de origen de las Herramientas para desarrolladores de Chrome en el panel Application, que muestra ValidTokenNotProvided y Status Expired

Recibirás correos electrónicos automáticos cuando sea necesario enviar comentarios o cuando un token esté por vencer, pero no cuando finalice la prueba.

La prueba del origen está disponible para el usuario actual

Algunas pruebas de origen no están disponibles para ciertos usuarios, incluso si se proporciona un token válido.

Si una prueba no está disponible para el usuario actual, las Herramientas para desarrolladores de Chrome mostrarán una advertencia de TrialNotAllowed:

Información de las pruebas de origen de las Herramientas para desarrolladores de Chrome en el panel Application que muestra la advertencia PruebaNotAllowed.

Se proporcionará información sobre las restricciones de uso y la disponibilidad para cada prueba de origen.

Al igual que con cualquier función de la plataforma web, debes usar la detección de funciones para confirmar que una función de prueba de origen sea compatible antes de usarla.

No se superaron las restricciones de uso de la prueba del origen

De forma predeterminada, se habilitará una función de prueba de origen en cualquier página que tenga un token válido para la prueba.

Sin embargo, salvo en casos excepcionales, el uso de las pruebas de origen está limitado a un máximo del 0.5% de todas las cargas de páginas de Chrome. La función de prueba de origen se inhabilitará si el uso total de todos los usuarios de Chrome supera ese importe. DevTools mostrará el estado del token como inhabilitado.

No hay límites de uso para las pruebas de baja, ya que no presentan funciones nuevas y, por lo tanto, no representan un riesgo de hacer que una proporción significativa de la Web dependa de una función de prueba.

Algunas pruebas también proporcionan una opción para limitar el uso, lo que significa que las funciones de la prueba de origen se inhabilitarán para algunos usuarios. Esta opción está disponible desde la página de registro para una prueba de origen que la ofrece:

Página de registro de las pruebas de origen de Chrome que muestra las restricciones de uso.

Si observas que el acceso de los usuarios a una función de prueba de origen es menor de lo esperado, asegúrate de que esté seleccionado el "Límite estándar".

Los iframes proporcionan sus propios tokens

Para permitir el acceso a una función de prueba de origen, un iframe debe proporcionar un token en una metaetiqueta, un encabezado HTTP o de forma programática. Los iframes no heredan el acceso a las funciones habilitadas para las páginas que los contienen.

ot-iframe.glitch.me demuestra el acceso a una función de prueba de origen desde un iframe. ot-iframe-3p.glitch.me proporciona varios ejemplos de iframes de origen cruzado.

Las políticas de permisos están configuradas correctamente

Algunas funciones de la prueba de origen pueden verse afectadas por un encabezado Permissions-Policy (antes conocido como encabezado Feature-Policy). Puedes verificar esto en la sección Intent to Experiment de la función de prueba o en la documentación para desarrolladores de la función en web.dev o developer.chrome.com/blog.

Asegúrate de que la función a la que intentas acceder no esté bloqueada por una directiva Permissions-Policy. Puedes verificar los encabezados de respuesta en el panel Network de Chrome DevTools y ver la lista completa de funciones permitidas en el panel Application.

Panel de la aplicación de Chrome DevTools, que muestra la función Permitida por la política de permisos

¿Qué sucede con los trabajadores?

Las funciones de las pruebas de origen se pueden poner a disposición de los service workers, los trabajadores compartidos y los trabajadores dedicados. Sin embargo, la única forma de habilitar el acceso de los trabajadores del servicio y los trabajadores compartidos es proporcionar un token en un encabezado Origin-Trial.

Los trabajadores dedicados heredan el acceso a las funciones habilitadas por su documento superior.

El token se proporciona antes de acceder a las funciones

Asegúrate de proporcionar un token de prueba de origen antes de acceder a una función de prueba. Por ejemplo, si una página proporciona un token a través de JavaScript, asegúrate de que el código para proporcionar el token se ejecute antes que el código que intente acceder a la función de prueba.

Demostraciones de pruebas de origen

Más información