BitField Library

Библиотека для работы с битовыми флагами в TypeScript/JavaScript.

Особенности

• 🔍 Удобное управление флагами
• 📦 Миниатюрный размер (~1KB)

Установка

npm install bitfield-lib

или

yarn add bitfield-lib

Использование

Базовый пример:

import { BitField } from 'bitfields-lib'

const FLAGS = {
	READ: 1 << 0, // 0b0001
	WRITE: 1 << 1, // 0b0010
	EXECUTE: 1 << 2, // 0b0100
}

const perms = new BitField()

// Установка флагов
perms.set(FLAGS.READ | FLAGS.WRITE)

// Проверка
perms.contains(FLAGS.READ) // true
perms.contains(FLAGS.EXECUTE) // false

// Переключение
perms.toggle(FLAGS.EXECUTE)

Привязанные флаги:

const FilePermissions = BitField.withFlags({
	READ: 1 << 0,
	WRITE: 1 << 1,
	EXECUTE: 1 << 2,
})

const userPerms = new FilePermissions()
userPerms.set(FilePermissions.flags.READ | FilePermissions.flags.WRITE)

API

• set(flag) - Устанавливает флаг
• unset(flag) Снимает флаг
• toggle(flag) Переключает флаг
• contains(flag) Проверяет наличие флага
• getValue() Возвращает текущее значение

Статические методы:

BitField.all() // Все флаги установлены
BitField.withFlags(flags) // Создаёт класс с привязанными флагами

Производительность

| Операция | Скорость (оп/сек) | | ------------ | ----------------- | | Установка | ~15 млн | | Проверка | ~20 млн | | Переключение | ~12 млн |

Лицензия

MIT © 2025 FarryDay