メインコンテンツまでスキップ

serverExternalPackages

Server ComponentsRoute Handlers内で使用される依存関係は、Next.jsによって自動的にバンドルされます。

依存関係がNode.js固有の機能を使用している場合、特定の依存関係をServer Componentsのバンドルから除外し、ネイティブのNode.js requireを使用することができます。

next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
serverExternalPackages: ['@acme/ui'],
}

module.exports = nextConfig

Next.jsには、現在互換性の作業が進行中で、自動的に除外される人気のあるパッケージの短いリストが含まれています:

  • @appsignal/nodejs
  • @aws-sdk/client-s3
  • @aws-sdk/s3-presigned-post
  • @blockfrost/blockfrost-js
  • @highlight-run/node
  • @huggingface/transformers
  • @jpg-store/lucid-cardano
  • @libsql/client
  • @mikro-orm/core
  • @mikro-orm/knex
  • @node-rs/argon2
  • @node-rs/bcrypt
  • @prisma/client
  • @react-pdf/renderer
  • @sentry/profiling-node
  • @sparticuz/chromium
  • @swc/core
  • @xenova/transformers
  • argon2
  • autoprefixer
  • aws-crt
  • bcrypt
  • better-sqlite3
  • canvas
  • chromadb-default-embed
  • cpu-features
  • cypress
  • dd-trace
  • eslint
  • express
  • firebase-admin
  • import-in-the-middle
  • isolated-vm
  • jest
  • jsdom
  • keyv
  • libsql
  • mdx-bundler
  • mongodb
  • mongoose
  • newrelic
  • next-mdx-remote
  • next-seo
  • node-cron
  • node-pty
  • node-web-audio-api
  • onnxruntime-node
  • oslo
  • pg
  • playwright
  • playwright-core
  • postcss
  • prettier
  • prisma
  • puppeteer-core
  • puppeteer
  • require-in-the-middle
  • rimraf
  • sharp
  • shiki
  • sqlite3
  • ts-node
  • ts-morph
  • typescript
  • vscode-oniguruma
  • webpack
  • websocket
  • zeromq
バージョン変更点
v15.0.0実験的から安定版に移行。serverComponentsExternalPackagesからserverExternalPackagesに名称変更