IMPORTANT: This library doesn't validate the token, any well formed JWT can be decoded. You should validate the token in your server-side logic by using something like express-jwt, koa-jwt, Owin Bearer JWT, etc.
📚 Documentation - 🚀 Getting Started - 💬 Feedback
- Docs site - explore our docs site and learn more about Auth0.
Install with NPM or Yarn.
Run npm install jwt-decode
or yarn add jwt-decode
to install the library.
import jwt_decode from "jwt-decode";
var token = "eyJ0eXAiO.../// jwt token";
var decoded = jwt_decode(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):
var decodedHeader = jwt_decode(token, { header: true });
console.log(decodedHeader);
/* prints:
* {
* typ: "JWT",
* alg: "HS256"
* }
*/
Note: A falsy or malformed token will throw an InvalidTokenError
error.
The jwt_decode
function will return an unknown
type by default. You can specify what the expected return type should be by passing a type argument to the jwt_decode
function.
The package also exports types for a JwtHeader
and JwtPayload
with some default claims. You can either use them as-is, or extend them to include non standard claims or properties.
import jwtDecode, { JwtPayload } from "jwt-decode";
const token: string = "eyJhsw5c";
const decoded = jwtDecode<JwtPayload>(token); // Returns with the JwtPayload type
const jwt_decode = require('jwt-decode');
...
Copy the file jwt-decode.js
from the build/
folder to your project somewhere, then include like so:
<script src="jwt-decode.js"></script>
We appreciate feedback and contribution to this repo! Before you get started, please see the following:
To provide feedback or report a bug, please raise an issue on our issue tracker.
Please do not report security vulnerabilities on the public GitHub issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.
Auth0 is an easy to implement, adaptable authentication and authorization platform. To learn more checkout Why Auth0?
This project is licensed under the MIT license. See the LICENSE file for more info.