Nuxt 4.7: wat eraan komt en wat je zelf aanzet
Nuxt 4.7 staat gepland voor 20 november. De release bevat veel werk aan snelheid: op de server, in de browser en in de bundel. Dit stuk schrijf ik op basis van de release-notes en de pull requests. Zodra 4.7 uit is, test ik het op mijn eigen sites en werk ik dit artikel bij met de cijfers.
Kort gezegd
- 01 staticRoutes verdubbelt het aantal verzoeken per seconde in de test van het Nuxt-team
- 02 De pagina komt eerder in beeld, zonder dat je iets aanzet
- 03 Runtime config kan nu een schema hebben: een ontbrekend secret stopt de server
- 04 Nog niet uit: ik werk dit stuk bij met eigen metingen na de release
staticRoutes: dezelfde router voor elk verzoek
Bij elk verzoek maakt Nuxt op de server een nieuwe router. Die bouwt elke keer opnieuw de lijst met routes op, ook al verandert die lijst nooit. Bij een kleine pagina is dat ongeveer de helft van de tijd die het renderen kost.
Met experimental.staticRoutes bouwt de server die lijst één keer en gebruikt hij hem voor elk verzoek.
export default defineNuxtConfig({
experimental: { staticRoutes: true }
})In de test van het Nuxt-team ging de homepage van 1324 naar 2700 verzoeken per seconde. Een productpagina ging van 1411 naar 2932. Dat is ruim twee keer zoveel, op dezelfde server.
Er zijn twee voorwaarden. Je code mag geen routes toevoegen of weghalen terwijl de app draait. router.addRoute, removeRoute en clearRoutes geven dan een fout. En een router.options die de routes aanpast, laat de build mislukken. Routes die een module bij de build toevoegt, zoals een CMS met extendPages, zijn geen probleem.
De optie zet ook early404 aan. Daarover schreef ik in Wat Nuxt 4.6 sneller maakt: met een catch-all pagina zoals [...slug].vue doet die niets. Bij een site met een CMS is dat bijna altijd zo. De winst van één router voor alle verzoeken krijg je dan wel.
De pagina komt eerder in beeld
Tot nu toe werkte de browser na het laden van de HTML alles in één keer af: de JavaScript, de plugins en de hydration. Pas daarna tekende hij de pagina. Bij een pagina die op de server gerenderd is, wacht Nuxt 4.7 nu eerst tot de browser de pagina in beeld heeft gezet. Daarna start de app, in kleinere stukken. De browser kan tussendoor op een klik of scroll reageren.
Dit krijg je gratis met de upgrade. Je merkt het vooral op tragere telefoons, waar die ene lange taak het langst duurde.
Runtime config met een schema
In runtimeConfig kun je nu per waarde een schema zetten, bijvoorbeeld met Zod of Valibot. Het schema bepaalt het type, en of de waarde verplicht is.
import { z } from 'zod'
export default defineNuxtConfig({
runtimeConfig: {
apiSecret: z.string(),
session: z.object({
maxAge: z.number().int().default(60 * 60)
})
}
})apiSecret heeft hier geen standaardwaarde, dus hij is verplicht. Ontbreekt NUXT_API_SECRET op de server, dan start de server niet. Dat is beter dan een site die draait en pas bij de eerste aanroep een fout geeft. NUXT_SESSION_MAX_AGE=7200 wordt een getal, geen string.
Op Nuxt 4 is dit iets wat je zelf kiest. Waarden zonder schema werken zoals voorheen. Met compatibilityVersion: 5 verandert dat: elke omgevingsvariabele krijgt het type van zijn standaardwaarde. Een string die op een getal lijkt, zoals 4848e0, blijft dan een string. Zet je die vlag aan als voorbereiding op Nuxt 5, kijk dan je .env en de variabelen op de server na.
Wat je verder gratis krijgt
Gebruikt je app nergens
$fetch, dan zitofetchniet meer in de bundel voor de browser. Dat scheelt ongeveer 6 kB. Laadt een los script$fetchop een manier die Nuxt niet ziet, zet danexperimental.globalFetchaan.<NuxtLink>wordt nog lichter, op de server en in de browser.CSS die al in de HTML staat, haalt de browser niet nog een keer op.
Lege delen van de payload gaan niet meer mee in de HTML.
Een link met een
download-attribuut laat Nuxt nu aan de browser over.
Upgraden
Zodra 4.7 uit is, upgrade je zoals altijd:
npx nuxt upgrade --dedupeZet staticRoutes eerst aan in een test- of stagingomgeving. Werkt de site daar, inclusief de pagina’s uit je CMS, dan kan hij live.
Wil je weten waar jouw winst zit?
Met de snelheidsaudit kijk ik verder dan de score, van server tot klik. Vaste prijs: € 850.