NextRequest
NextRequest 扩展了 Web Request API,增加了一些便利方法。
cookies
读取或修改请求的 Set-Cookie
header。
set(name, value)
给定一个名称,在请求中设置具有给定值的 cookie。
get(name)
给定一个 cookie 名称,返回该 cookie 的值。如果未找到 cookie,则返回 undefined
。如果找到多个 cookie,则返回第一个。
getAll()
给定一个 cookie 名称,返回该 cookie 的值。如果没有提供名称,则返回请求中的所有 cookie。
delete(name)
给定一个 cookie 名称,从请求中删除该 cookie。
has(name)
给定一个 cookie 名称,如果请求中存在该 cookie 则返回 true
。
clear()
从请求中移除 Set-Cookie
header。
nextUrl
扩展了原生的 URL
API,增加了额外的便利方法,包括 Next.js 特有的属性。
可用的选项如下:
属性 | 类型 | 描述 |
---|---|---|
basePath | string | URL 的基础路径。 |
buildId | string | undefined | Next.js 应用的构建标识符。可以自定义。 |
pathname | string | URL 的路径名。 |
searchParams | Object | URL 的搜索参数。 |
**注意:**Pages 路由中的国际化属性在 App 路由中不可用。详细了解 App 路由的国际化。
版本历史
版本 | 变更 |
---|---|
v15.0.0 | 移除 ip 和 geo 。 |