Sources
Usar el panel Sources de Chrome
Usar el panel Sources de Chrome. Una función pequeña de esta página construye una puntuación de personalización a partir de una hora y del ancho del viewport. La oferta debería aparecer. No aparece. El panel Sources de Chrome es donde pausas esa función, entras en las funciones auxiliares y ves cambiar el valor.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Un script de práctica llama a una muestra fija, hora 14 y ancho 1280, y dibuja el retorno en esta pestaña. El botón no envía ese objeto.
Cómo usarlo
- El archivo de práctica se carga por su cuenta.
- El botón llama a esa única muestra fija.
- Compara el retorno con 40 y con la oferta.
- El resultado se queda en esta pestaña. No se envía.
Los atajos son para Chrome en Mac y en Windows. En un portátil Mac, F8, F9, F10 y F11 suelen necesitar también Fn, salvo que el teclado use las teclas F como teclas de función estándar. Los atajos con Command no necesitan Fn. Pasa el cursor por un botón de la barra para confirmar el atajo en el Chrome que tienes abierto.
Abre DevTools y el panel Sources
Haz clic en la página una vez para que el atajo llegue al navegador y luego abre DevTools.
MacCommand + Option + IWindowsF12 or Control + Shift + IDevTools vuelve a abrir el panel que usaste la última vez. Si ese panel no es Sources, haz clic en la pestaña Sources. El Command Menu también puede abrirlo: ejecuta Show Sources.
MacCommand + Shift + PWindowsControl + Shift + PCommand + ] en Mac, o Control + ] en Windows, enfoca el panel siguiente. Console tiene su propio atajo si quieres ese cajón: Command + Option + J en Mac, Control + Shift + J en Windows.
Dos barras laterales importan cuando estás en pausa. La izquierda es el árbol de archivos. La derecha tiene el call stack, el scope y los watches.
MacCommand + Shift + YWindowsControl + Shift + YEse par muestra u oculta el árbol de archivos.
MacCommand + Shift + HWindowsControl + Shift + HEse par muestra u oculta la barra lateral del depurador.
La puntuación de práctica
El archivo es personalization-score.js. La función es buildPracticeBeacon. Pide a cuatro funciones auxiliares una banda de hora, una banda de ancho, una puntuación y un slot. El botón siempre pasa la misma muestra, así que todos los navegadores dan con el mismo fallo.
Los cortes de hora son los que usa el resto del sitio: morning desde las 5, afternoon desde las 12, evening desde las 17 y night en el resto. Los cortes de ancho son los mismos cortes de dispositivo: mobile por debajo de 760, tablet por debajo de 1100 y desktop desde 1100. La oferta empieza en 40, la misma línea que el laboratorio de intención.
Tarde
De la hora 12 hasta la 17. 10 puntos. La hora 14, la muestra, cae aquí.
Escritorio
Ancho desde 1100. 30 puntos. 1280, la muestra, cae aquí.
Las otras horas
Morning vale 15, evening vale 20, night vale 5.
Los otros anchos
Mobile vale 10. Tablet vale 20.
10 + 30 son 40, así que esta muestra debería tomar el slot offer. Ejecútala y luego usa los pasos para ver por qué el panel no está de acuerdo.
Solo esta pestaña
Ejecutar la puntuación de práctica
El botón llama a buildPracticeBeacon con hour 14 y un viewport de 1280px de ancho. El valor de retorno se dibuja abajo. No se envía.
- Hora de muestra
- 14 · 14:00 · afternoon · 10 puntos
- Ancho de muestra
- 1280px · desktop · 30 puntos
Aún no hay ninguna ejecución.
- Espera a que el botón diga Ejecutar la puntuación de práctica. Eso significa que /debug/personalization-score.js ha cargado.
- Abre el archivo. Command + O o Command + P en Mac. Control + O o Control + P en Windows. Escribe personalization-score y abre ese script. En el árbol de archivos está bajo este host, en debug.
- Salta a la función. Command + Shift + O en Mac, Control + Shift + O en Windows, escribe buildPracticeBeacon, y pulsa Enter.
- Haz clic en el número de línea junto a const hourBand = bandForHour(signals.hour). El número se pone azul. Con el cursor en esa línea, Command + B en Mac o Control + B en Windows alterna el mismo breakpoint. DevTools pausa antes de que se ejecute la línea.
- Deja desmarcada la casilla de debugger. Haz clic en Ejecutar la puntuación de práctica. La página pausa en esa línea.
- En el Call stack, selecciona buildPracticeBeacon si hay otro frame seleccionado. En Scope → Local, signals es hour 14 y viewportWidth 1280. hourBand aún no está asignado.
- Step into con F11. Caes en bandForHour. Step over con F10 hasta que devuelva afternoon. Step out con Shift + F11 si sigues dentro de la función auxiliar. De vuelta en buildPracticeBeacon, hourBand es afternoon.
- Step into en bandForWidth. Step over hasta que devuelva desktop, y luego step out. widthBand es desktop.
- Step into en scoreBands. Step into en pointsForHour. El local band es afternoon, y el return es 10. Step out. hourPoints es 10. Step into en pointsForWidth. El return es 30. Step out. widthPoints es 30.
- En Watch, haz clic en + y añade hourPoints + widthPoints. Marca 40. Añade hourPoints + widthBand. Marca "10desktop". Pasa el cursor por widthPoints y widthBand en el editor. El número y la palabra están ambos en scope. El return usa la palabra.
- Step over del return. Step into en slotForScore. Scope → Closure muestra OFFER_AT como 40. El local score es la cadena. La comparación falla, así que el slot se queda en default.
- Resume con F8. El panel bajo el botón muestra el objeto que volvió. Abre La línea que está mal si quieres el relato en una línea, incluido cómo parchearlo en el editor y ejecutarlo otra vez.
Encontrar archivos, incluidos los source maps
Command + P (Mac) o Control + P (Windows) busca archivos que la página ha cargado. Command + O y Control + O hacen lo mismo. Command + Shift + O, o Control + Shift + O, salta a una función del archivo abierto. Escribe scoreBands para caer en la función auxiliar donde vive el return.
Busca en todos los archivos cargados con Command + Option + F en Mac, o Control + Shift + F en Windows. Control + G, en ambos, va a una línea del archivo abierto. También puedes abrir el Command Menu y escribir dos puntos y el número de línea.
El código de la aplicación en este sitio va en un bundle. Un bundle suele ser una línea larga, y los nombres son cortos. El botón {} abajo a la izquierda del editor hace pretty-print de esa línea. Si Chrome ya la ha partido, un guion en el margen de números marca la continuación. El pretty-print hace el texto legible. No restaura los nombres originales de las funciones.
Un source map es un archivo acompañante que el navegador puede descargar. El script lo señala con un comentario sourceMappingURL. Cuando Enable JavaScript source maps está activo (Settings → Preferences → Sources; empieza activo), DevTools puede mostrar los archivos originales. El menú del árbol de archivos tiene Group by Authored/Deployed: Authored es el fuente mapeado, Deployed es el archivo que ejecutó el navegador. Los frameworks conocidos también pueden listar rutas de terceros bajo el campo del source map ignoreList, que alimenta la ignore list de más abajo.
Este sitio no publica un source map de navegador para los bundles de Next.js. El archivo de práctica se sirve solo, sin minificar, en /debug/personalization-score.js, así que el recorrido coincide con producción. Si Command + P no lo encuentra, recarga cuando el botón haya terminado de cargar.
Breakpoints de línea
Un breakpoint de línea pausa antes de que esa línea se ejecute. Haz clic en el número de línea, o pon el cursor en la línea y pulsa Command + B (Mac) o Control + B (Windows). La marca es azul. Haz clic otra vez para quitarla.
La lista Breakpoints de la barra lateral del depurador los agrupa por archivo. La casilla junto a una fila desactiva ese breakpoint sin borrarlo. Command + F8 en Mac, o Control + F8 en Windows, desactiva todos los breakpoints para que el botón pueda terminar. Púlsalo otra vez para volver a activarlos.
En pausa, mantén Command (Mac) o Control (Windows) y haz clic en una línea posterior para continuar hasta esa línea. Haz clic derecho en un número de línea y elige Continue to here para el mismo salto.
Breakpoints condicionales y logpoints
Un breakpoint condicional es un breakpoint de línea que pausa solo cuando una expresión es verdadera. Haz clic derecho en el número de línea del return dentro de scoreBands y elige Add conditional breakpoint. Command-clic en el número de línea en Mac, o Control-clic en Windows. Con el cursor en la línea, Command + Option + B o Control + Alt + B abre el mismo editor.
Usa widthBand === "desktop". La marca se pone naranja. Quita el breakpoint azul normal de hourBand, o ese seguirá pausando en cada ejecución. Haz clic en el botón. Paras en el return, con hourPoints y widthPoints ya rellenos.
Un logpoint escribe en Console y no pausa. Command + Shift + clic en un número de línea en Mac, o Control + Shift + clic en Windows, y elige el campo de logpoint. En la línea return { dentro de buildPracticeBeacon, escribe score, slot. La marca es rosa. Resume, haz clic en el botón y la consola imprime la puntuación de tipo string y el slot default. slot se puede registrar en esa línea porque la línea de arriba ya lo ha asignado. Un logpoint en la propia línea de asignación se ejecutaría antes de la asignación.
Breakpoints de DOM, XHR/fetch y event listener
Un breakpoint de DOM pausa en el código que cambie un nodo. Abre Elements (Command + Shift + C en Mac, Control + Shift + C en Windows, y luego haz clic en el cuadro de resultado). También puedes pasar a Elements y buscar #practice-beacon-result. Haz clic derecho en ese nodo y luego Break on → Subtree modifications. Desactiva los breakpoints de línea con Command + F8 o Control + F8 para no parar antes. Haz clic en el botón. DevTools pausa en el código que escribe el resultado. Esa pausa es después de que buildPracticeBeacon haya hecho return, y a menudo cae en un archivo de bundle. Attribute modifications vigilan los atributos de ese nodo. Node removal vigila que se quite el nodo. Subtree modifications son las que ven aparecer el texto del resultado.
Un breakpoint de XHR/fetch pausa cuando la URL de una petición contiene el texto que escribes. En Sources, abre XHR/fetch Breakpoints (algunas versiones de Chrome dicen XHR Breakpoints), haz clic en + e introduce collect. El botón de práctica no envía una petición. Con el consentimiento encendido, este sitio hace POST a /api/collect para un page view, y la etiqueta de Google pide /g/collect. Cualquiera de las dos URL contiene collect, así que el breakpoint puede pausar ahí. El Laboratorio de recolección es la página que muestra el beacon.
Un breakpoint de event listener pausa en el listener que se ejecuta después de un evento. En Sources, abre Event Listener Breakpoints, despliega Mouse y marca click. Haz clic en Ejecutar la puntuación de práctica. La primera pausa puede ser un listener del framework en la página, no buildPracticeBeacon. Ese es el momento de la ignore list: haz clic derecho en ese frame del call stack y elige Add script to ignore list. Resume, y mantén el breakpoint de línea en el archivo de práctica si aún quieres caer ahí.
La sentencia debugger
debugger es un breakpoint de línea que vive en el fuente. Marca Pause on the debugger statement, desactiva los demás breakpoints y haz clic en el botón con DevTools abierto. La ejecución se detiene en esa línea dentro de buildPracticeBeacon, antes de que se ejecuten las funciones auxiliares. Con DevTools cerrado, la sentencia no hace nada.
Desmarca la casilla cuando termines. Una sentencia debugger dejada en una función publicada pausa a cada visitante que tenga DevTools abierto. Esta solo se ejecuta cuando la casilla está marcada, y solo en el archivo de práctica.
Recorrer paso a paso
Los cinco botones están arriba de Sources cuando la página está en pausa. Tanto Step como Step into saltan los scripts de la ignore list. Quita un script de la lista cuando necesites entrar en él.
Resume
Ejecuta hasta el siguiente breakpoint.
MacF8 or Command + \WindowsF8 or Control + \Step over
Ejecuta esta línea. Si llama a una función, ejecuta la función entera y luego pausa en la línea siguiente.
MacF10 or Command + 'WindowsF10 or Control + 'Step into
Entra en la función que llama esta línea. También pausa después de un await, en la línea que se ejecuta cuando la promesa se resuelve.
MacF11 or Command + ;WindowsF11 or Control + ;Step out
Termina la función en la que estás y pausa en quien la llamó.
MacShift + F11 or Command + Shift + ;WindowsShift + F11 or Control + Shift + ;Step
Entra en la función que llama esta línea y no pauses al otro lado de un await. Las funciones de práctica son síncronas, así que Step y Step into caen en la misma línea.
MacF9WindowsF9
Call stack y scope
El Call stack lista los frames que te trajeron hasta aquí, el más reciente primero. Haz clic en un frame para mostrar su fuente y su scope. El frame seleccionado es el que usan la consola y los watches. Control + . y Control + , bajan y suben por la pila tanto en Mac como en Windows.
En pausa dentro de pointsForWidth, la pila es esa función auxiliar, luego scoreBands, luego buildPracticeBeacon, y luego el clic que lo empezó. Los frames de scripts ignorados están ocultos. Marca Show ignore-listed frames bajo el Call stack para verlos en gris.
Scope es la misma barra lateral. Local es la función que seleccionaste: en scoreBands, eso es hourBand, widthBand, hourPoints, y widthPoints. Closure es el scope circundante que la función usa de verdad. En slotForScore, Closure muestra OFFER_AT. Global es el objeto global. bbpDebugPractice es el único nombre que este archivo añade ahí. Contiene la función. No es un beacon y no se envía.
Haz doble clic en un valor de Scope para editarlo durante el resto de esta pausa. Detente en el if dentro de slotForScore, cambia score de la cadena al número 40, y haz step over. El slot pasa a offer. La comparación estaba dispuesta. La puntuación que llegó no era un número. La edición dura esta llamada. El siguiente clic vuelve a ejecutar el archivo.
Expresiones de Watch
Watch evalúa una expresión cada vez que pausas o avanzas, en el frame seleccionado. Haz clic en + en Watch, o selecciona hourPoints + widthPoints en el editor y pulsa Command + Shift + A (Mac) o Control + Shift + A (Windows).
Los nombres pertenecen a un frame. hourPoints existe en scoreBands. Si el frame seleccionado es buildPracticeBeacon, ese watch no está disponible. Haz clic en el frame scoreBands y vuelve a marcar 40. Borra un watch desde el control que aparece al pasar el cursor por su fila.
Pasar el cursor y la consola en pausa
En pausa, pasa el cursor por una variable para ver su valor. Chrome también imprime el valor actual junto a la declaración. Pasa el cursor por widthBand en la línea del return y obtienes la palabra desktop. Pasa el cursor por widthPoints y obtienes 30.
Escape alterna el cajón. La consola, en pausa, evalúa en el frame de llamada seleccionado. En scoreBands, escribe hourPoints + widthPoints y typeof (hourPoints + widthBand). La primera es el número 40. La segunda es "string". Selecciona la expresión en el editor y pulsa Command + Shift + E (Mac) o Control + Shift + E (Windows) para ejecutar esa selección en la consola.
Desde la consola también puedes llamar tú a la función: bbpDebugPractice.buildPracticeBeacon({ hour: 14, viewportWidth: 1280 }). Eso sigue quedándose en esta pestaña.
Blackboxing y la ignore list
Chrome llama a esto ignore list. Los artículos más antiguos lo llaman blackboxing. Un script ignorado se queda fuera del camino: sus frames se ocultan en el call stack y el recorrido no entra en él. El archivo de práctica debería quedarse fuera de la lista. El bundle del framework con el que tropiezas desde un breakpoint de clic, o un script de etiqueta, es el tipo de archivo para el que sirve la lista.
Añade un script desde cualquiera de estos sitios:
- Haz clic derecho en el archivo o en su carpeta en el árbol de archivos y luego Add script to ignore list o Add directory to ignore list.
- Haz clic derecho dentro del archivo abierto y elige Add script to ignore list.
- Haz clic derecho en un frame del Call stack y elige Add script to ignore list.
Settings es F1, o Fn + F1 en un portátil Mac. Abre la pestaña Ignore List. Enable Ignore Listing es el interruptor principal. Add content scripts to ignore list omite los scripts de extensiones. Automatically add known third-party scripts to ignore list usa el campo ignoreList de los source maps. Las reglas de exclusión personalizadas empiezan por /node_modules/ y /bower_components/. Add pattern acepta un nombre o una expresión regular, por ejemplo googletagmanager\.com.
El árbol de archivos pone en gris los fuentes ignorados. Su menú puede ocultarlos. Show ignore-listed frames devuelve los frames grises al call stack cuando quieres el camino completo.
La línea que está mal
Mostrar el return dentro de scoreBands
scoreBands calcula widthPoints, y luego devuelve hourPoints + widthBand. widthBand es la palabra desktop. JavaScript une un número y una cadena, así que la puntuación es "10desktop". slotForScore compara esa cadena con 40. La comparación es falsa, así que el slot se queda en default. El return que coincide con la tabla es hourPoints + widthPoints.
Para probar el arreglo en esta pestaña, pausa en ese return, cambia widthBand por widthPoints, y guarda con Command + S (Mac) o Control + S (Windows). Chrome parchea la función y la reinicia. Resume. Si un breakpoint de línea vuelve a pausar la página, pulsa Command + F8 o Control + F8 para desactivar los breakpoints y haz clic en el botón otra vez. El slot debería marcar offer. Recarga cuando quieras de nuevo el archivo del servidor. El guardado se aplica a la copia de esta pestaña.
Qué guarda esta página
La puntuación se queda en esta pestaña. Los controles de práctica están marcados para que un clic ahí no se registre. Abrir este laboratorio sigue el mismo interruptor de consentimiento que las demás páginas: un page view solo se guarda después de que aceptas. El archivo de práctica no llama a fetch. El laboratorio de Llamadas es la continuación: un segundo archivo de práctica que editas para que llame a las API públicas de solo lectura de este sitio. Consentimiento muestra qué cambia ese interruptor, y el Laboratorio de recolección muestra un beacon cuando se envía uno.
RecorridoCómo lo hicimosMostrarOcultar
El ajuste de proveedor de ejemplo está marcado abajo. Los números de eVar y de event son ejemplos. Este laboratorio no llama a Adobe.
El laboratorio de Sources carga un script de práctica y llama a buildPracticeBeacon con la hora 14 y el ancho 1280, y luego dibuja el retorno en la pestaña. El botón no publica ese objeto, y el laboratorio no llama a Adobe.
Cargar el archivo de práctica por su cuenta
Una etiqueta script pide /debug/personalization-score.js cuando la página ya es interactiva. El botón sigue desactivado hasta que ese script avisa que está listo.
Llamar a una muestra fija
run lee window.bbpDebugPractice y llama a buildPracticeBeacon con la hora 14, el ancho de viewport 1280 y la casilla de debugger. El retorno se guarda en el estado de React.
Comparar el retorno con 40 y offer
EXPECTED es score 40 y slot offer. El panel dice que la ejecución coincide solo cuando ambos campos igualan esos valores. El retorno de práctica publicado no lo hace.
Dejar el resultado en la pestaña
La región de práctica está marcada data-track-ignore. El componente no llama a fetch y no llama a trackLabEvent. Una pausa de debugger solo corre cuando la casilla está activa y DevTools está abierto.
Del código
El botón llama a buildPracticeBeacon y compara el retorno con score 40 y slot offer.
function run() {
const api = practiceApi()
if (!api) {
setBeacon(null)
setError(tr(locale, "The practice file is not available yet. Reload the page and try again.", "El archivo de práctica aún no está disponible. Recarga la página e inténtalo otra vez."))
return
}
setError("")
setBeacon(api.buildPracticeBeacon({ ...SAMPLE, pause }))
}
const matches =
beacon !== null && beacon.score === EXPECTED.score && beacon.slot === EXPECTED.slotEl archivo de práctica es un script aparte. El botón sigue desactivado hasta que carga.
<Script
id="personalization-score"
src="/debug/personalization-score.js"
strategy="afterInteractive"
onReady={() => {
setFailed(false)
setReady(true)
}}
onError={() => {
setReady(false)
setFailed(true)
}}
/>Google y Adobe
Este laboratorio no encola un evento propio. El bloque de Google muestra un ejemplo de cómo rastrearías la interacción. Adobe también es un ejemplo.
Este laboratorio no encola un evento de analítica propio. Después de Aceptar, el sitio sigue encolando virtual_page_view de la página, con page_path y page_title. Los clics dentro de una región data-track-ignore no se registran. El push de abajo es un ejemplo, no una llamada de esta página. Este sitio no llama a gtag('set') ni a Adobe.
Solo ejemplo. Esta página no hace push de este objeto.
// Example only. This lab does not queue this event.
dataLayer.push({
event: "practice_score_example",
hour: 14,
slot: "offer",
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar105, prop105 y event105 son números de variable de ejemplo. En Launch, un elemento de datos lee el valor y una regla lo envía cuando el valor cambia. En el report suite, habilita eVar105 con asignación Most Recent y haz que expire en el hit. Una processing rule no hace falta si el elemento de datos se mapea directo a esa eVar.
Payload de alloy de ejemplo. _example es un esquema de relleno, no un inquilino real.
alloy("sendEvent", {
xdm: {
eventType: "web.webinteraction.linkClicks",
_example: {
practiceSlot: "offer",
},
},
})Hit de ejemplo. eVar105 tiene alcance de hit en este ejemplo. prop105 muere en el mismo hit.
s.eVar105 = "offer"
s.prop105 = "offer"
s.events = "event105"
s.linkTrackVars = "eVar105,prop105,events"
s.linkTrackEvents = "event105"
s.tl(true, "o", "practice_score_example")Traducción
Cada campo del laboratorio, el nombre en GA4 y la variable de Adobe de ejemplo. El alcance es la parte que suele perderse en la traducción.
Puntuación
GA4. No se envía. El retorno se dibuja en la pestaña.
Adobe. eVar105 de ejemplo, expira en el hit. No se envía.
Alcance. Un valor de retorno local. No es un parámetro de evento ni una propiedad de usuario.
Slot
GA4. No se envía. La tabla espera offer. El retorno de práctica se queda en default.
Adobe. prop105 de ejemplo, que muere en el hit. No se envía.
Alcance. Hit, si rastrearas el slot. No es una propiedad de la visita.
Banda de hora
GA4. No se envía.
Adobe. eVar105 de ejemplo. No se envía.
Alcance. Un resultado local de una función auxiliar. No es un evento ni una propiedad de usuario.
Pausa de debugger
GA4. No se envía. La casilla solo pasa pause a la llamada de práctica.
Adobe. prop105 de ejemplo. No se envía.
Alcance. Un control de DevTools en este hit. No cambia la visita.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…