Vercel Doctor

Billedoptimering

Regler der opdager mønstre, som forårsager unødvendige billedoptimeringsomkostninger.

Disse regler identificerer fejlkonfigurationer i Next.js' billedhåndtering, der øger brugen af Vercel Image Optimization eller serverer uoptimerede billeder.

vercel-image-global-unoptimized

Warning · vercel-doctor/vercel-image-global-unoptimized

Opdager images.unoptimized: true i next.config.

Hvorfor det er vigtigt: Dette deaktiverer Vercel Image Optimization globalt. Alle billeder serveres som de er, uden størrelsesændring, formatkonvertering eller komprimering — hvilket øger båndbreddeomkostninger og forringer ydeevnen.

Bad
// next.config.js
module.exports = {
  images: {
    unoptimized: true,
  },
};
Good
// next.config.js
module.exports = {
  images: {
    remotePatterns: [{ hostname: "cdn.example.com" }],
  },
};

nextjs-image-missing-sizes

Warning · vercel-doctor/nextjs-image-missing-sizes

Opdager <Image>-komponenter med fill men uden sizes-attribut.

Hvorfor det er vigtigt: Uden sizes downloader browseren det størst tilgængelige billede uanset viewport-bredde. Dette spilder båndbredde og øger brugen af Image Optimization.

Bad
<Image src="/hero.jpg" alt="Hero" fill />
Good
<Image src="/hero.jpg" alt="Hero" fill sizes="(max-width: 768px) 100vw, 50vw" />

vercel-image-remote-pattern-too-broad

Warning · vercel-doctor/vercel-image-remote-pattern-too-broad

Opdager images.remotePatterns-poster med alt for brede pathname-mønstre (/** eller manglende).

Hvorfor det er vigtigt: Ubegrænsede remote billedstier tillader enhver URL på hostnavnet at blive optimeret via din konto, hvilket potentielt skaber uventet optimeringsforbrug fra brugergenereret indhold eller tredjepartsembeds.

Bad
// next.config.js
module.exports = {
  images: {
    remotePatterns: [{ hostname: "cdn.example.com", pathname: "/**" }],
  },
};
Good
// next.config.js
module.exports = {
  images: {
    remotePatterns: [{ hostname: "cdn.example.com", pathname: "/avatars/**" }],
  },
};

vercel-image-svg-without-unoptimized

Warning · vercel-doctor/vercel-image-svg-without-unoptimized

Opdager <Image>-komponenter med en SVG src, der ikke har unoptimized-prop'en.

Hvorfor det er vigtigt: SVG'er er vektorgrafik og drager ikke fordel af Image Optimization-pipelinen. At køre dem igennem den spilder optimeringskvoten uden nogen fordel.

Bad
<Image src="/logo.svg" alt="Logo" width={100} height={40} />
Good
<Image src="/logo.svg" alt="Logo" width={100} height={40} unoptimized />
Edit on GitHub

Last updated on

On this page