πΊπΈ English version | π·πΊ Π ΡΡΡΠΊΠ°Ρ Π²Π΅ΡΡΠΈΡ
Managed collection of items with hooks, events, and strict type safety.
npm install @webeach/collectionor
pnpm install @webeach/collectionor
yarn add @webeach/collectionES Modules
import { Collection } from '@webeach/collection';CommonJS
const { Collection } = require('@webeach/collection');Browser
<script type="module">
import { Collection } from 'https://unpkg.com/@webeach/collection';
</script>import { Collection } from '@webeach/collection';
const users = new Collection({
primaryKey: 'id',
});
users.appendItem({
id: 1,
firstName: 'Ivan',
lastName: 'Petrov',
});
users.appendItem({
id: 2,
firstName: 'Jason',
lastName: 'Statham',
});
console.log(users.numItems); // 2
console.log(users.getItem(2).firstName); // Jasonimport { Collection } from '@webeach/collection';
const products = new Collection({
primaryKey: 'sku',
});
products.appendItem({ sku: 'A001', name: 'Laptop' });
products.replaceItem('A001', { sku: 'A001', name: 'Laptop Pro' });
console.log(products.getItem('A001')?.name); // 'Laptop Pro'import { Collection } from '@webeach/collection';
const tasks = new Collection({
primaryKey: 'id',
initialItems: [
{ id: 1, title: 'Initial Task 1' },
{ id: 2, title: 'Initial Task 2' },
],
});
// Completely replace the collection content
tasks.setItems([
{ id: 3, title: 'New Task 3' },
{ id: 4, title: 'New Task 4' },
]);
console.log(tasks.numItems); // 2
console.log(tasks.getItem(3)?.title); // 'New Task 3'- constructor
- Methods
- Properties
- Hooks
- constructor
- Inherits CustomEvent API
Releases are handled automatically using semantic-release.
Before publishing a new version, make sure:
- All changes are committed and pushed to the
mainbranch. - Commit messages follow the Conventional Commits format:
feat: ...β for new featuresfix: ...β for bug fixeschore: ...,refactor: ..., etc. β as needed
- Versioning is automatically determined based on commit types (
patch,minor,major).
Development and maintenance: Ruslan Martynov
If you have suggestions or found a bug, feel free to open an issue or submit a pull request.
This package is distributed under the MIT License.