jwt decode下载 - jwt decode源代码下载

jwt decode

其他源码

v4.0.0

下载

重要提示：该库不验证令牌，任何格式良好的 JWT 都可以解码。您应该使用express-jwt、koa-jwt、Microsoft.AspNetCore.Authentication.JwtBearer 等来验证服务器端逻辑中的令牌。

文档 - 入门 - 反馈

文档

文档站点 - 浏览我们的文档站点并了解有关 Auth0 的更多信息。

入门

安装

使用 NPM 或 Yarn 安装。

运行npm install jwt-decode或yarn add jwt-decode来安装库。

用法

 import { jwtDecode } from "jwt-decode" ;

const token = "eyJ0eXAiO.../// jwt token" ;
const decoded = jwtDecode ( token ) ;

console . log ( decoded ) ;

/* prints:
 * { 
 *   foo: "bar",
 *   exp: 1393286893,
 *   iat: 1393268893  
 * }
 */

// decode header by passing in options (useful for when you need `kid` to verify a JWT):
const decodedHeader = jwtDecode ( token , { header : true } ) ;
console . log ( decodedHeader ) ;

/* prints:
 * { 
 *   typ: "JWT",
 *   alg: "HS256" 
 * }
 */

注意：虚假或格式错误的令牌将引发InvalidTokenError错误；有关特定错误的更多信息，请参阅下文。

聚填充atob

该库依赖于atob() ，这是所有现代浏览器以及每个支持的节点环境上可用的全局函数。

为了在无法访问atob()环境（例如 React Native）中使用jwt-decode ，请确保使用core-js/stable/atob在应用程序中提供相应的 polyfill：

 import "core-js/stable/atob" ;

或者，您也可以自己使用base-64和 polyfill global.atob ：

 import { decode } from "base-64" ;
global . atob = decode ;

错误

该库适用于有效的 JSON Web 令牌。这些令牌的基本格式是

 [part1].[part2].[part3]

所有部分都应该是有效的 base64 (url) 编码的 json。根据{ header: <option> }选项，它将解码第 1 部分（仅当指定 header: true 时）或第 2 部分（默认）

不遵守格式将导致InvalidTokenError并显示以下消息之一：

Invalid token specified: must be a string => 传递的令牌不是字符串，该库仅适用于字符串。
Invalid token specified: missing part # => 这可能意味着您在令牌中缺少一个点 ( . )
Invalid token specified: invalid base64 for part # =>该部分无法进行base64解码（消息应包含base64解码器给出的错误）
Invalid token specified: invalid json for part # => 该部分已正确进行 Base64 解码，但是，解码后的值不是有效的 JSON（消息应包含 JSON 解析器给出的错误）

与 TypeScript 一起使用

jwtDecode函数的返回类型由作为第二个参数传递的对象的header属性确定。如果省略（或设置为 false），它将使用JwtPayload ，如果为 true ，它将使用JwtHeader 。如果需要，您可以通过将类型参数传递给jwtDecode函数来指定预期的返回类型。

您可以扩展JwtHeader和JwtPayload以包含非标准声明或属性。

 import { jwtDecode } from "jwt-decode" ;

const token = "eyJhsw5c" ;
const decoded = jwtDecode < JwtPayload > ( token ) ; // Returns with the JwtPayload type

用作 CommonJS 包

 const { jwtDecode } = require ( 'jwt-decode' ) ;
...

包含脚本标签

将文件jwt-decode.js从build/esm文件夹的根目录复制到项目的某个位置，然后在标有type="module"的脚本标记内导入jwtDecode ：

 < script type =" module " >
  import { jwtDecode } from "/path/to/jwt-decode.js" ;

  const token = "eyJhsw5c" ;
  const decoded = jwtDecode ( token ) ;
</ script >