支持的浏览器
浏览器支持情况,以及 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,包括:
- fetch() —— 替代:
whatwg-fetch和unfetch。 - URL —— 替代:
url包(Node.js API)。 - Object.assign() —— 替代:
object-assign、object.assign和core-js/object/assign。
如果你的任何依赖项包含这些 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 还支持:
- Async/await(ES2017)
- 对象剩余/展开属性(ES2018)
- 动态
import()(ES2020) - 可选链(ES2020)
- 空值合并(ES2020)
- 类字段和静态属性(ES2022)
- 等等!
TypeScript 特性#
Next.js 内置 TypeScript 支持。在此了解更多。
自定义 Babel 配置(高级)#
你可以自定义 Babel 配置。在此了解更多。