Komponenter
Changelog nav-dekoratoren-moduler
Breaking changes i nye versjoner av nav-dekoratoren-moduler.
Ny funksjon
Denne komponenten er ny eller oppdatert. Tar du den i bruk ønsker vi gjerne innspill til hvordan den fungerer i tjenesten din!
Egnet til:
- Team som bruker nav-dekoratoren-moduler
4.5.0 - Konsumentlogging
Dekoratøren logger hvilken app som kaller den, slik at feil kan knyttes til riktig team. Kilden til appens identitet avhenger av hvordan du integrerer Dekoratøren:
| Integrasjon | Identifisering | Hva du må gjøre |
|---|---|---|
| SSR med moduler-pakken | NAIS_APP_NAME.NAIS_NAMESPACE | Ingen ting. Moduler-pakken setter `teamName` automatisk. |
| SSR uten moduler-pakken | Query-parameteren `teamName` | Sett `teamName` på kallet til `/ssr`. |
| CSR med moduler-pakken | `params.teamName` | Sett `teamName` i `injectDecoratorClientSide`. Hvis den mangler, brukes HTTP-headeren `Origin` når den finnes. |
| CSR uten moduler-pakken | HTTP-headeren `Origin` | Ingen ting. Nettleseren sender `Origin` automatisk ved cross-origin-kall. |
Bruk formatet appnavn.namespace, for eksempel min-side.personbruker. Verdien må ha minst ett punktum og kan bare inneholde små bokstaver (`a-z`), tall (`0-9`), bindestrek og punktum.
Ved SSR uten moduler-pakken legger du parameteren i URL-en:
GET https://www.nav.no/dekoratoren/ssr?context=privatperson&teamName=min-side.personbrukerVed CSR med moduler-pakken legger du den i params:
injectDecoratorClientSide({ env: 'prod', params: { context: 'privatperson', teamName: 'min-side.personbruker', },});Hvis teamName er ugyldig, forkaster Dekoratøren verdien og bruker Origin som fallback når headeren finnes. Manglende identitet stopper ikke kallet. Moduler-pakken varsler i appens konsoll når teamName mangler ved CSR eller ikke kan settes automatisk ved SSR. Dekoratørens server varsler ved manglende identitet for SSR uten moduler-pakken og CSR uten moduler-pakken, samt for CSR med moduler-pakken når både teamName og Origin mangler.
Les mer om konsumentlogging og service discovery i Dekoratørens ReadMe.
4.3.0 - Analytics
Denne versjonen inneholder breaking changes for analytics.
| Før | Nå |
|---|---|
| getAmplitudeInstance() | getAnalyticsInstance() |
| logAmplitudeEvent() | logAnalyticsEvent() |
Analytics-funksjonene bruker strengere typer fra `@navikt/analytics-types`. Bytt ut bruk av de gamle funksjonene, og sjekk at eventnavn og payload følger typene pakken forventer.
Trenger du hjelp?
Hvis du er usikker på hvordan migreringen skal gjøres i din app, bør du oppdatere én integrasjon om gangen og verifisere analytics-events før du går videre.
