Naar hoofdinhoud gaan
Sourcemaps zijn een manier om backtraces van geminificeerde of getranspileerde JavaScript-bestanden te converteren naar hun oorspronkelijke weergave in uw broncode. Een sourcemap bevat gegevens over uw front-end-broncode, waarmee we de functienaam, het regel- en kolomnummer en de omringende broncode kunnen afleiden vanuit de positie waarnaar in de backtrace wordt verwezen.

Vereisten

Het verrijken van backtraces met sourcemaps vereist dat elk monster wordt voorzien van een revision van uw applicatie. Dit wordt gebruikt om te bepalen wanneer er nieuwe sourcemaps moeten worden opgehaald nadat een deploy uw (front-end-)code heeft gewijzigd. U kunt de revisie opgeven in de opties die u meegeeft bij het aanmaken van een nieuwe AppSignal-instantie.
const appsignal = new Appsignal({
  key: "<your frontend API key>",
  revision: "<your current revision>",
});

Publieke sourcemaps

Bij publieke sourcemaps wordt de sourcemap naast het JavaScript-bestand gehost. Onderaan het geminificeerde JavaScript-bestand moet een speciale opmerking staan die aangeeft dat er een sourcemap beschikbaar is voor de code.
//# sourceMappingURL=file.js.map
De URL in deze opmerking kan een volledige URL naar de sourcemap zijn, of een relatief pad vanaf het JavaScript-bestand naar de sourcemap. Als de geminificeerde JS bijvoorbeeld wordt gehost op https://your.app/assets/application.min.js en de sourcemap-opmerking eruitziet als //# sourceMappingURL=application.min.js.map, proberen we de sourcemap op te halen vanaf de volgende URL: https://your.app/assets/application.min.js.map. We proberen publieke sourcemaps te cachen, maar het kan voorkomen dat we de geminificeerde versie en het sourcemap-bestand meer dan eens opvragen.

Privé-sourcemaps

We raden over het algemeen aan om waar mogelijk publieke sourcemaps te gebruiken, omdat builds die veel sourcemaps produceren lang kunnen duren om via onze privé-sourcemap-endpoint te uploaden. Als dat echter niet mogelijk is, kunt u uw sourcemaps ook uploaden naar onze sourcemaps-API-endpoint.

Bewaartermijn

Sourcemaps worden gegroepeerd tot een “release” op basis van de revision-string en we bewaren de laatste “release” totdat er een nieuwe revision wordt geüpload. Oudere “releases” worden tot zestig dagen bewaard.