https://github.com/jsprismarine/jsbinaryutils
A TypeScript / JavaScript library for managing buffers in a NodeJS app.
https://github.com/jsprismarine/jsbinaryutils
binary binary-stream hacktoberfest node npm
Last synced: 7 months ago
JSON representation
A TypeScript / JavaScript library for managing buffers in a NodeJS app.
- Host: GitHub
- URL: https://github.com/jsprismarine/jsbinaryutils
- Owner: JSPrismarine
- Created: 2020-10-06T20:31:03.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-02-23T14:34:25.000Z (almost 2 years ago)
- Last Synced: 2025-07-03T04:07:17.310Z (7 months ago)
- Topics: binary, binary-stream, hacktoberfest, node, npm
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/@jsprismarine/jsbinaryutils
- Size: 438 KB
- Stars: 3
- Watchers: 0
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/@jsprismarine/jsbinaryutils)
[](#)
# JSBinaryUtils
A TypeScript / JavaScript library for managing buffers in a NodeJS app.
This library has been created to solve the big overhead of resources usage when a project needs to write some new data very often in the same Buffer instance (Buffer.concat will create new Buffers, so it's really bad for the performance of real time applications, and that is why JSBinaryUtils was created).
:warning: This guide is incomplete, please help by contributing! thank you :)
- [JSBinaryUtils](#jsbinaryutils)
- [Installation](#installation)
- [API](#api)
- [Reading](#reading)
- [read(len: number)](#read)
- [readByte()](#readbyte)
- [readSignedByte()](#readsbyte)
- [readBoolean()](#readboolean)
- [readShort()](#readshort)
- [readShortLE()](#readshortle)
- [readUnsignedShort()](#readushort)
- [readUnsignedShortLE()](#readushortle)
- [readTriad()](#readtriad)
- [Writing](#writing)
- [write(buffer: Uint8Array | Buffer)](#write)
## Installation
Install by `npm`
```sh
npm install @jsprismarine/jsbinaryutils
```
**or** install with `yarn`
```sh
yarn add @jsprismarine/jsbinaryutils
```
# Api
A BinaryStream instance can be used for reading or for writing but not both at the same time.
## Reading
Reads a slice of bytes in the buffer on the stream instance and returns it in a Buffer.
### Usage
```typescript
import BinaryStream from "@jsprismarine/jsbinaryutils";
const stream = new BinaryStream(Buffer.from([255, 255, 200, 2]));
console.log(stream.read(4)); // Buffer < 0xFF 0xFF 0xFF 0xC8 0x02 >
```
Reads an unsigned byte from the buffer (0 to 255).
### Usage
```typescript
import BinaryStream from "@jsprismarine/jsbinaryutils";
const stream = new BinaryStream(Buffer.from([0xFF]));
console.log(stream.readByte()); // 255
```
Reads a signed byte from the buffer (-128 to 127).
### Usage
```typescript
import BinaryStream from "@jsprismarine/jsbinaryutils";
const stream = new BinaryStream(Buffer.from([0x7F]));
console.log(stream.readSignedByte()); // 127
```
Reads a boolean (1 byte, either true or false).
Everything that is not 0x00 is true.
### Usage
```typescript
import BinaryStream from "@jsprismarine/jsbinaryutils";
const stream = new BinaryStream(Buffer.from([0x01]));
console.log(stream.readBoolean()); // true
```
Reads a signed big-endian short (2 bytes).
Reads a signed little-endian short (2 bytes).
Reads an unsigned big-endian short (2 bytes).
Reads an unsigned little-endian short (2 bytes).
Reads a big-endian triad (3 bytes).
Reads a little-endian triad (3 bytes).
Reads an unsigned big-endian triad (3 bytes).
Reads an unsigned little-endian triad (3 bytes).
Reads a signed big-endian integer (1 byte, 0 to 255).
todo...
## Writing
### write(buffer: Uint8Array | Buffer)
Concatenates the given buffer with the stream instance one.
### Usage
```typescript
import BinaryStream from "@jsprismarine/jsbinaryutils";
const stream = new BinaryStream();
stream.write(Buffer.from([255, 255, 200, 2]));
console.log(stream.getBuffer()); // Buffer < 0xFF 0xFF 0xFF 0xC8 0x02 >
```