Subir Source Maps

Sube source maps a OpenReplay.

Subir Source Maps

OpenReplay permite desminificar JavaScript mediante source maps. Al subirlos a OpenReplay, podrás ver el contexto del código fuente obtenido de los stack traces en su forma original, lo cual resulta muy útil para depurar código minificado (UglifyJS) o código transpilado (TypeScript, ES6).

Instala el módulo NPM sourcemap-uploader:

npm i -g @openreplay/sourcemap-uploader

Asegúrate de que tu build genere archivos de source map (.map) separados. Por ejemplo, si usas webpack, tu configuración debería incluir la siguiente opción devtool:

{ devtool: ‘source-map’ }

Subir Source Maps a OpenReplay

Section titled Subir Source Maps a OpenReplay

A continuación, debes configurar tu proceso de build para crear los distintos archivos de código fuente. Los source maps se pueden subir para un único archivo:

sourcemap-uploader -s https://openreplay.mycompany.com/api -k API_KEY -p PROJECT_KEY file -m ./dist/index.js.map -u https://myapp.com/index.js

O para un directorio que incluya muchos archivos. En ese caso, la URL debe corresponder (ruta exacta) a la raíz desde la que subes los archivos JS del directorio. Es decir, si tienes tu app-42.js junto con el app-42.js.map en la carpeta ./build y luego quieres subirlo a tu instancia de OpenReplay para que sea accesible a través del enlace https://myapp.com/static/app-42.js, entonces el comando debería ser así:

sourcemap-uploader -s https://openreplay.mycompany.com/api -k API_KEY -p PROJECT_KEY dir -m ./build -u https://myapp.com/static
  • -s: La URL de tu instancia de OpenReplay. Asegúrate de añadirle /api. No especifiques este parámetro si estás en OpenReplay Cloud.
  • -k: API Key (se encuentra en ‘Preferences’ > ‘Account’ > ‘Organization API Key’).
  • -p: Project Key (se encuentra en ‘Preferences’ > ‘Projects’).
  • -m: Ruta a los archivos de source map (también puede ser un directorio).
  • -u: URL del recurso JavaScript (si es un único archivo) o URL base (en caso de un directorio).
  • -l: Para mostrar los registros de subida.

Si tienes alguna pregunta sobre este proceso, no dudes en contactarnos en nuestro Slack o consulta nuestro Foro.