CLI后端云原生【免费下载链接】vercelDevelop. Preview. Ship.项目地址https://gitcode.com/gh_mirrors/ve/vercel点击查看免费下载getContext()是vercel/oidc运行时工具包中用于读取当前请求上下文的底层函数它通过全局符号Symbol.for(vercel/request-context)获取运行时注入的上下文对象。这篇指南将以该函数的 API 文档为主体结合仓库源码、运行时注入实现与配套的 OIDC Token 读取函数帮助你理解请求上下文机制如何在 Vercel FunctionsNode、Edge中工作以及如何在自己的函数代码里安全地使用它。函数签名与基本语义getContext()的签名非常简单见 getContext.mdgetContext(): Context它在 packages/oidc/src/get-context.ts:7 中定义返回类型为Context。整个函数只做一件事从globalThis上取回当前请求的上下文对象如果取不到则返回一个空对象{}。返回类型 ContextContext类型的定义位于 packages/oidc/src/get-context.ts:1-3type Context { headers?: Recordstring, string; };也就是说getContext()的返回值中可能包含一个headers字段用于存放字符串键值对的请求头集合。headers是可选字段因此调用方在使用前需要做可选性判断例如可选链?.。底层实现全局符号请求上下文getContext()的实现完全围绕一个特殊的全局符号展开见 packages/oidc/src/get-context.ts:5-12export const SYMBOL_FOR_REQ_CONTEXT Symbol.for(vercel/request-context); export function getContext(): Context { const fromSymbol: typeof globalThis { [SYMBOL_FOR_REQ_CONTEXT]?: { get?: () Context }; } globalThis; return fromSymbol[SYMBOL_FOR_REQ_CONTEXT]?.get?.() ?? {}; }这里有三个值得注意的细节Symbol.for(vercel/request-context)是全局共享符号。与普通Symbol()不同Symbol.for()会在全局符号注册表中查找/创建符号这意味着跨包、跨模块只要使用同一个字符串 key就能访问到同一个全局符号。这正是vercel/oidc与 Vercel 运行时Node/Edge 适配层之间传递请求上下文的握手协议。符号上挂载的是一个带get方法的对象。运行时注入的结构形如{ get: () Context }getContext()通过可选链安全地调用get()若符号不存在、对象没有get方法则回退到{}。返回值总是可控的。即使完全没有任何运行时注入例如在浏览器或普通 Node 进程中调用getContext()也不会抛错而是返回空对象保证调用方可以安全地继续执行。运行时如何注入请求上下文要理解getContext()的取值来源需要看 Vercel 运行时层是如何把请求上下文挂到全局符号上的。仓库中packages/nodeNode.js 运行时同时为两种函数类型注入了该符号Serverless 函数注入点在 packages/node/src/serverless-functions/serverless-handler.mts:177-185 中Serverless 函数处理器在启动用户代码前用Object.defineProperty把上下文挂到全局Object.defineProperty(globalThis, Symbol.for(vercel/request-context), { enumerable: false, configurable: true, value: { get: () ({ waitUntil: awaiter.waitUntil.bind(awaiter), }), }, });注意这里通过defineProperty挂载的属性是**不可枚举enumerable: false**的避免污染globalThis的常规属性遍历。Edge 函数注入点在 packages/node/src/edge-functions/edge-handler.mts:191-195 中Edge Runtime 实例同样把请求上下文挂到全局符号上runtime.context.globalThis[Symbol.for(vercel/request-context)] { get: () ({ waitUntil: params.awaiter.waitUntil.bind(params.awaiter), }), };关键观察上下文中目前提供的是 waitUntil从上述两处注入点可以看到当前 Vercel 运行时在请求上下文中提供的能力是waitUntil用于在响应完成后继续执行后台任务。而getContext()返回的Context类型中定义的headers字段用于承载请求头信息其典型消费方正是下文要讲的 OIDC Token 读取链路。getContext 与 OIDC Token 的协作getContext()在vercel/oidc包中最核心的用途是为读取 OIDC Token 提供请求头来源。在 packages/oidc/src/get-vercel-oidc-token-sync.ts:25-37 中可以看到完整的读取顺序export function getVercelOidcTokenSync(): string { const token getContext().headers?.[x-vercel-oidc-token] ?? process.env.VERCEL_OIDC_TOKEN; if (!token) { throw new Error( The x-vercel-oidc-token header is missing from the request. ); } return token; }该函数的取值逻辑可以拆解为两级回退先从请求上下文读取getContext().headers?.[x-vercel-oidc-token]—— 即平台通过请求上下文注入的x-vercel-oidc-token请求头回退到环境变量若请求头不存在则读取process.env.VERCEL_OIDC_TOKEN两者皆无则抛错抛出The x-vercel-oidc-token header is missing from the request.。这一请求头优先、环境变量兜底的设计同时见于 getVercelOidcToken.md 的说明保证了函数在请求上下文中携带了 token 时直接使用请求级 token而在其他场景如本地开发、构建脚本下也能通过环境变量工作。各运行环境的导出差异getContext()被包的所有入口统一导出但在不同运行环境下与其配套的 Token 函数行为不同。从 package.json 的exports映射可以看到三种入口入口条件对应文件getContextgetVercelOidcToken 行为edge-lightindex-edge-light.ts正常导出只返回请求级 token不支持自动刷新见 index-edge-light.ts:22-27browser/react-native/workflowindex-browser.ts正常导出返回空字符串占位见 index-browser.ts:11-13默认Node import/requireindex.ts正常导出支持在开发环境自动刷新过期 token值得一提的是getContext()本身在浏览器入口中也是完整导出的index-browser.ts:1但在浏览器等非 Vercel 运行时环境中由于没有平台注入全局符号getContext()会返回{}这正是它设计为空对象回退的原因——让 API 在所有环境下都能被安全调用。使用建议与注意事项1. 直接消费 getContext() 的场景如果你的函数代码需要读取平台注入的请求级信息可以像getVercelOidcTokenSync一样通过getContext()安全取值import { getContext } from vercel/oidc; const headers getContext().headers ?? {}; const customValue headers[x-custom-header]; // 可能为 undefined2. 优先使用高层 Token API对于 OIDC Token 场景官方推荐直接使用 getVercelOidcToken()它内部已经封装了getContext()的请求头读取、环境变量回退以及在开发环境下过期自动刷新详见 get-vercel-oidc-token-with-refresh.ts:96-141import { getVercelOidcToken } from vercel/oidc; const token await getVercelOidcToken(); console.log(OIDC Token:, token);3. 不要缓存 token 值vercel/oidc的文档README.md、getVercelOidcToken.md反复强调Do not cache this value, as it is subject to change in production!—— 生产环境中 token 可能随请求而变化请求级 token 每次请求都由平台注入因此应在每次请求时实时获取不要跨请求缓存。4. 结合验证函数使用获取到 token 后可在服务端通过 verifyVercelOidcToken() 对 token 做 JWT 校验默认使用https://oidc.vercel.com/.well-known/jwks的远程 JWKS算法限定 RS256并校验project_id、environment、owner_id等声明见 verify-vercel-oidc-token.ts:53-106形成获取—验证的完整闭环。相关 API 一览getContext()属于vercel/oidc公共 API 中的基础函数该包的完整导出可见 index.ts与其紧密相关的还有getVercelOidcToken(options?)异步获取 OIDC Token开发环境下支持过期自动刷新API 文档getVercelOidcTokenSync()同步获取 token已标记为 deprecated推荐改用getVercelOidcTokenAPI 文档exchangeVercelOidcToken(options)将 token 换取指定 audience 的新 token带 LRU 过期感知的内存缓存API 文档verifyVercelOidcToken(token, options?)基于远程 JWKS 验证 tokenAPI 文档getVercelToken(options?)读取 CLI 认证配置中的 Vercel 访问令牌API 文档。完整的包级使用示例可参考 packages/oidc/README.md其中包括通过project/team支持 ID 与 slug 两种形式显式指定刷新目标以及通过expirationBufferMs设置提前刷新阈值等配置方式。小结getContext()是vercel/oidc与 Vercel 运行时之间的一座桥梁它借助全局符号Symbol.for(vercel/request-context)把平台在 Serverless 与 Edge 运行时中注入的请求上下文安全地暴露给业务代码并以空对象回退保证任意环境下的可调用性。理解它的实现与注入点不仅能帮你厘清x-vercel-oidc-token请求头的来源也能让你在需要访问请求级上下文信息时写出与 Vercel 运行时机制一致的健壮代码。赞分享CLI后端云原生【免费下载链接】vercelDevelop. Preview. Ship.项目地址https://gitcode.com/gh_mirrors/ve/vercel点击查看免费下载相关推荐深入解析 vercel/oidc 的 getVercelOidcTokenSync从请求上下文与环境变量同步获取 Vercel OIDC Token深入解析 vercel/oidc 的 getVercelOidcTokenSync从请求上下文与环境变量同步获取 Vercel OIDC Token getCLI后端云原生Vercel OIDC Token 获取指南深入解析 vercel/oidc 的 getVercelOidcToken()Vercel OIDC Token 获取指南深入解析 vercel/oidc 的 getVercelOidcToken getVercelOidcTokenCLI后端云原生AssetRipper 完整实操指南如何把 Unity 游戏资源解包成原生资产AssetRipper 完整实操指南如何把 Unity 游戏资源解包成原生资产 AssetRipper 是一款免费开源、跨平台的 Unity 资源提取工具基开发工具逆向工程游戏开发上一篇3步搞定视频PPT提取从视频到可打印讲义的完整指南下一篇四步解锁微信聊天记录WechatDecrypt工具终极指南与完整教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考