NNext.js 中文网 GitHub

支持的浏览器

浏览器支持情况,以及 Next.js 支持哪些 JavaScript 特性。

Next.js 支持现代浏览器,无需任何配置。

  • Chrome 111+
  • Edge 111+
  • Firefox 111+
  • Safari 16.4+

Browserslist#

如果你希望针对特定浏览器或特性,Next.js 支持在 package.json 文件中使用 Browserslist 配置。Next.js 默认使用以下 Browserslist 配置:

package.json
{
  "browserslist": ["chrome 111", "edge 111", "firefox 111", "safari 16.4"]
}

Polyfill#

我们会注入广泛使用的 polyfill,包括:

如果你的任何依赖项包含这些 polyfill,它们会自动从生产构建中移除,以避免重复。

此外,为了减小包体大小,Next.js 只会为需要这些 polyfill 的浏览器加载它们。全球大部分网络流量都不会下载这些 polyfill。

自定义 Polyfill#

如果你自己的代码或任何外部 npm 依赖项需要目标浏览器(例如 IE 11)不支持的特性,你需要自行添加 polyfill。

在 App Router 中#

要包含 polyfill,你可以将它们导入到 instrumentation-client.js 文件中。

instrumentation-client.ts
import './polyfills'

在 Pages Router 中#

在这种情况下,你应该在自定义 <App>或单个组件中,为你需要的特定 polyfill添加顶层导入。

pages/_app.tsx
import './polyfills'

import type { AppProps } from 'next/app'

export default function MyApp({ Component, pageProps }: AppProps) {
  return <Component {...pageProps} />
}
pages/_app.jsx
import './polyfills'

export default function MyApp({ Component, pageProps }) {
  return <Component {...pageProps} />
}

按需加载 Polyfill#

最佳做法是将不受支持的特性隔离到特定的 UI 区域,并在需要时按需加载 polyfill。

hooks/analytics.ts
import { useCallback } from 'react'

export const useAnalytics = () => {
  const tracker = useCallback(async (data: unknown) => {
    if (!('structuredClone' in globalThis)) {
      const mod = await import('polyfills/structured-clone')
      globalThis.structuredClone = mod.default
    }

    /* 执行一些使用结构化克隆的操作 */
  }, [])

  return tracker
}
hooks/analytics.js
import { useCallback } from 'react'

export const useAnalytics = () => {
  const tracker = useCallback(async (data) => {
    if (!('structuredClone' in globalThis)) {
      const mod = await import('polyfills/structured-clone')
      globalThis.structuredClone = mod.default
    }

    /* 执行一些使用结构化克隆的操作 */
  }, [])

  return tracker
}

JavaScript 语言特性#

Next.js 允许你开箱即用地使用最新的 JavaScript 特性。除了 ES6 特性之外,Next.js 还支持:

TypeScript 特性#

Next.js 内置 TypeScript 支持。在此了解更多。

自定义 Babel 配置(高级)#

你可以自定义 Babel 配置。在此了解更多。

Next.js 中文网