NextJS中文文档 - Next Request
NextRequest 扩展了 Web Request API,增加了额外的便捷方法。
cookies
读取或修改请求的 Set-Cookie
头。
set(name, value)
给定名称,在请求上设置具有给定值的 cookie。
ts
// 给定传入请求 /home
// 设置一个 cookie 来隐藏横幅
// 请求将有一个 `Set-Cookie:show-banner=false;path=/home` 头
request.cookies.set('show-banner', 'false')
1
2
3
4
2
3
4
get(name)
给定 cookie 名称,返回 cookie 的值。如果找不到 cookie,则返回 undefined
。如果找到多个 cookie,则返回第一个。
ts
// 给定传入请求 /home
// { name: 'show-banner', value: 'false', Path: '/home' }
request.cookies.get('show-banner')
1
2
3
2
3
getAll()
给定 cookie 名称,返回该 cookie 的值。如果未提供名称,则返回请求上的所有 cookie。
ts
// 给定传入请求 /home
// [
// { name: 'experiments', value: 'new-pricing-page', Path: '/home' },
// { name: 'experiments', value: 'winter-launch', Path: '/home' },
// ]
request.cookies.getAll('experiments')
// 或者,获取请求的所有 cookie
request.cookies.getAll()
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
delete(name)
给定 cookie 名称,从请求中删除该 cookie。
ts
// 删除返回 true,什么都没删除返回 false
request.cookies.delete('experiments')
1
2
2
has(name)
给定 cookie 名称,如果请求上存在该 cookie,则返回 true
。
ts
// 如果 cookie 存在则返回 true,不存在则返回 false
request.cookies.has('experiments')
1
2
2
clear()
从请求中移除 Set-Cookie
头。
ts
request.cookies.clear()
1
nextUrl
扩展了原生 URL
API,增加了额外的便捷方法,包括 Next.js 特有的属性。
ts
// 给定请求 /home,pathname 是 /home
request.nextUrl.pathname
// 给定请求 /home?name=lee,searchParams 是 { 'name': 'lee' }
request.nextUrl.searchParams
1
2
3
4
2
3
4
以下选项可用:
版本历史
版本 | 变更 |
---|---|
v15.0.0 | 移除了 ip 和 geo 。 |