Saltar al contenido principal
El checkout de Yuno dentro de VTEX pasa de Web SDK 1.6 a Web SDK 1.11. Desde Web SDK 1.9, cada clase e id que renderiza el SDK se llama sdk-payments-* en lugar de yuno-* o Yuno-*. Por ejemplo, Yuno-accordion__heading pasa a ser sdk-payments-accordion__heading. Después de la actualización no se produce ningún error. El CSS y JS personalizado que apunta a un nombre antiguo simplemente deja de aplicarse: un elemento oculto vuelve a mostrarse, un botón con estilo personalizado vuelve al estilo predeterminado, un script que lee un elemento no encuentra nada. Estos nombres siguen funcionando:
  • window.Yuno y el evento yuno-sdk-ready, que se mantienen como alias.
  • Los nombres que pertenecen a la capa de VTEX, como yuno-checkout-root, yuno-form-root, yuno-external-button-root, yuno-sdk-web-vtex-app y las clases de los botones express (yuno-google-pay-button, yuno-samsung-pay-button y sus grupos).
Usa una de las tres verificaciones siguientes antes de que la actualización llegue a tu tienda.

Opción 1: fragmento de consola en el checkout en vivo

Úsala para comprobar lo que carga la tienda en vivo, incluido el CSS de tu tema y de tus apps.
1

Abre el checkout en el paso de pago

Abre el checkout de tu tienda en Chrome, ve al paso de pago y asegúrate de que el formulario de Yuno esté visible.
2

Pega el fragmento en la consola de DevTools

Abre DevTools, ve a la pestaña Console, pega el fragmento y presiona Enter.
3

Lee la tabla

El fragmento imprime el paquete del SDK presente en la página, una tabla con cada regla CSS y cada script en línea que usa un nombre yuno-*, y el conteo de selectores que se rompen en 1.11. La columna on_1_11 indica BREAKS -> <new name> para un selector renombrado, BREAKS (removed) para un nombre sin equivalente, y ok o not an SDK name en los demás casos.
yuno-upgrade-check.browser.js
El fragmento obtiene el mapa de renombrado desde docs.y.uno, por lo que la consola necesita acceso de red a ese host. Si no se puede cargar el mapa, se detiene con un error en lugar de informar un resultado limpio. El fragmento no puede leer hojas de estilo servidas desde otro origen. Muestra cada una como una advertencia, así que revisa esos archivos a mano o con el escáner que se describe a continuación.

Opción 2: escáner sobre tus archivos

Úsala en los archivos que editas: checkout6-custom.css, checkout6-custom.js, una carpeta de tema o una app de VTEX IO. Requiere Node.js 18 o posterior.
1

Guarda el escáner como archivo

Copia el script siguiente en un archivo llamado yuno-upgrade-check.mjs. Carga el mapa de renombrado desde docs.y.uno por sí mismo; para ejecutarlo sin conexión, descarga el mapa de renombrado junto a él o apunta YUNO_RENAME_MAP al archivo.
yuno-upgrade-check.mjs
2

Ejecútalo sobre tus archivos o carpetas

Analiza los archivos .css, .scss, .less, .js, .mjs, .ts, .jsx, .tsx, .html, .vue, .liquid y .hbs y omite las carpetas node_modules, dist y build que se encuentren dentro de las rutas que indiques (una ruta que indiques explícitamente siempre se analiza). Un nombre del comercio que solo empieza como un nombre del SDK, como yuno-checkout-banner, se informa como not-sdk.
3

Lee el resultado

Cada línea muestra el estado, el archivo y la línea, el nombre y qué hacer. El código de salida es 1 cuando al menos un nombre se rompe en 1.11 y 0 en caso contrario, así que puedes ejecutarlo en CI.
Ejemplo de salida:

Opción 3: el mapa de renombrado

El mapa de renombrado es el archivo JSON que leen ambas herramientas. Úsalo para buscar un nombre a mano o para crear tu propia verificación. Enumera los 222 nombres de clases e ids encontrados en el paquete de Web SDK 1.6, además de los nombres de la capa de VTEX que no cambian: Un nombre que no está en el mapa no es un nombre del SDK 1.6. Lo más probable es que sea un id o una clase tuya y no necesita cambios.

Qué hacer ante una coincidencia

  1. Renamed: reemplaza el nombre antiguo por el nuevo en tu CSS o JS. Un selector que debe funcionar antes y después de la actualización puede incluir ambos nombres, por ejemplo .Yuno-accordion__heading, .sdk-payments-accordion__heading.
  2. Removed: abre el checkout en Web SDK 1.11 en sandbox, encuentra el elemento al que estaba dirigida tu regla y escribe el selector según el DOM de 1.11. Es posible que el elemento tenga otra estructura o que ya no exista.
  3. Prueba antes de producción: solicita a tu gerente técnico de cuenta una prueba en sandbox de tu checkout en Web SDK 1.11 con tus archivos personalizados aplicados.
Los mismos renombrados se aplican a cualquier comercio en Web SDK 1.6, 1.7 o 1.8 que pase a 1.9 o posterior, dentro o fuera de VTEX. El escáner y el mapa de renombrado funcionan igual para esas integraciones.