# token-types > Common token types for decoding and encoding numeric and string values Latest version **6.1.2** (published 2026-01-01) · MIT license · 0 weekly downloads ## Install ```sh npm install token-types pnpm add token-types yarn add token-types bun add token-types ``` ## Health **Score 65/100 (B)** — status: stable. Positive: has types; esm support; no vulnerabilities; high maintenance score; high quality score. Warnings: low downloads. ## Facts | | | |---|---| | Version | 6.1.2 | | Published | 2026-01-01 | | First published | 2017-06-18 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM | | Node | >=14.16 | | Dependencies | 3 | | Unpacked size | 21.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 11 | | Author | Borewit | | Maintainers | borewit | | Keywords | token, integer, unsigned, numeric, float, IEEE, 754, strtok3 | ## Links - npm: https://www.npmjs.com/package/token-types - Repository: https://github.com/Borewit/token-types - Homepage: https://github.com/Borewit/token-types#readme - Issues: https://github.com/Borewit/token-types/issues - Funding: https://github.com/sponsors/Borewit - npm.io page: https://npm.io/package/token-types ## Dependencies (3) - [ieee754](https://npm.io/package/ieee754.md) ^1.2.1 - [@tokenizer/token](https://npm.io/package/@tokenizer/token.md) ^0.3.0 - [@borewit/text-codec](https://npm.io/package/@borewit/text-codec.md) ^0.2.1 ## Recent versions - 6.1.2 (latest) — 2026-01-01 - 4.2.1 (cjs) — 2022-08-02 - 5.0.0-alpha.3 (esm) — 2022-08-01 - 6.1.1 — 2025-08-13 - 6.1.0 — 2025-08-12 - 6.0.4 — 2025-07-25 - 6.0.3 — 2025-06-29 - 6.0.2 — 2025-06-29 - 6.0.1 — 2025-06-28 - 6.0.0 — 2024-07-04 - 5.0.1 — 2022-08-02 - 5.0.0 — 2022-08-02 - 4.2.0 — 2022-02-23 - 5.0.0-alpha.2 — 2021-12-17 - 5.0.0-alpha.1 — 2021-12-16 - … 31 more at https://npm.io/package/token-types/versions ## README [![Node.js CI](https://github.com/Borewit/token-types/actions/workflows/nodejs-ci.yml/badge.svg?branch=master)](https://github.com/Borewit/token-types/actions/workflows/nodejs-ci.yml?query=branch%3Amaster) [![NPM version](https://badge.fury.io/js/token-types.svg)](https://npmjs.org/package/token-types) [![npm downloads](http://img.shields.io/npm/dm/token-types.svg)](https://npmcharts.com/compare/token-types,strtok3?start=1200&interval=30) [![coveralls](https://coveralls.io/repos/github/Borewit/token-types/badge.svg?branch=master)](https://coveralls.io/github/Borewit/token-types?branch=master) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/4723ce4613fc49cda8db5eed29f18834)](https://www.codacy.com/app/Borewit/token-types?utm_source=github.com&utm_medium=referral&utm_content=Borewit/token-types&utm_campaign=Badge_Grade) [![DeepScan grade](https://deepscan.io/api/teams/5165/projects/6940/branches/61852/badge/grade.svg)](https://deepscan.io/dashboard#view=project&tid=5165&pid=6940&bid=61852) [![Known Vulnerabilities](https://snyk.io/test/github/Borewit/token-types/badge.svg?targetFile=package.json)](https://snyk.io/test/github/Borewit/token-types?targetFile=package.json) # token-types A primitive token library used to read and write from a `Uint8Array`. Although it is possible to use this module directly, it is primarily designed to be used with [strtok3 tokenizer](https://github.com/Borewit/strtok3). ## Compatibility Module: version 5 migrated from [CommonJS](https://en.wikipedia.org/wiki/CommonJS) to [pure ECMAScript Module (ESM)](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c). JavaScript is compliant with [ECMAScript 2019 (ES10)](https://en.wikipedia.org/wiki/ECMAScript#10th_Edition_%E2%80%93_ECMAScript_2019). ## Installation ```sh npm install --save token-types ``` Usually in combination with [strtok3](https://github.com/Borewit/strtok3): ```sh npm install --save strtok3 ``` Using TypeScript you should also install [@tokenizer/token](https://github.com/Borewit/tokenizer-token) as a development dependency: ```shell npm install --save-dev @tokenizer/token ``` ## Example ```js import * as strtok3 from 'strtok3'; import * as token from 'token-types'; (async () => { const tokenizer = await strtok3.fromFile("somefile.bin"); try { const myNumber = await tokenizer.readToken(token.Float32_BE); console.log(`My number: ${myNumber}`); } finally { tokenizer.close(); // Close the file } })(); ``` ## Tokens ### Numeric tokens `token-types` supports a wide variety of numeric tokens out of the box: | Token | Number | Bits | Endianness | |---------------|------------------|------|----------------| | `UINT8` | Unsigned integer | 8 | n/a | | `UINT16_BE` | Unsigned integer | 16 | big endian | | `UINT16_LE` | Unsigned integer | 16 | little endian | | `UINT24_BE` | Unsigned integer | 24 | big endian | | `UINT24_LE` | Unsigned integer | 24 | little endian | | `UINT32_BE` | Unsigned integer | 32 | big endian | | `UINT32_LE` | Unsigned integer | 32 | little endian | | `UINT64_BE` | Unsigned integer | 64 | big endian | | `UINT64_LE`* | Unsigned integer | 64 | little endian | | `INT8` | Signed integer | 8 | n/a | | `INT16_BE` | Signed integer | 16 | big endian | | `INT16_LE` | Signed integer | 16 | little endian | | `INT24_BE` | Signed integer | 24 | big endian | | `INT24_LE` | Signed integer | 24 | little endian | | `INT32_BE` | Signed integer | 32 | big endian | | `INT32_LE` | Signed integer | 32 | little endian | | `INT64_BE` | Signed integer | 64 | big endian | | `INT64_LE`* | Signed integer | 64 | little endian | | `Float16_BE` | IEEE 754 float | 16 | big endian | | `Float16_LE` | IEEE 754 float | 16 | little endian | | `Float32_BE` | IEEE 754 float | 32 | big endian | | `Float32_LE` | IEEE 754 float | 32 | little endian | | `Float64_BE` | IEEE 754 float | 64 | big endian | | `Float64_LE` | IEEE 754 float | 64 | little endian | | `Float80_BE`* | IEEE 754 float | 80 | big endian | | `Float80_LE`* | IEEE 754 float | 80 | little endian | (*) The tokens exceed the JavaScript IEEE 754 64-bit Floating Point precision, decoding and encoding is best effort based. ### String tokens StringType decoding is using [@borewit/text-codec](https://github.com/Borewit/text-codec). ### Custom tokens Custom tokens can be added, suitable for reading binary files or network messages: ```js ExtendedHeader = { len: 10, get: (buf, off) => { return { // Extended header size size: Token.UINT32_BE.get(buf, off), // Extended Flags extendedFlags: Token.UINT16_BE.get(buf, off + 4), // Size of padding sizeOfPadding: Token.UINT32_BE.get(buf, off + 6), // CRC data present crcDataPresent: common.strtokBITSET.get(buf, off + 4, 31) }; } }; ``` ## Licence This project is licensed under the [MIT License](LICENSE.txt). Feel free to use, modify, and distribute as needed. --- _Source: https://npm.io/package/token-types · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._