Files
discord.js/packages/structures/__tests__/Structure.test.ts
Qjuh 3cff4d7412 feat: @discordjs/structures (#10900)
* chore: init /structures

* feat: base structure

* feat: initial structures design attempt

* refactor(Structure): use unknown to store in kData

* feat(Structure): add Invite

refactor(Structure): patch to _patch

* refactor: symbol names and override location

* fix: don't possibly return 0 if discord borks

Co-authored-by: Synbulat Biishev <signin@syjalo.dev>

* refactor: use getter value instead of api

Co-authored-by: Synbulat Biishev <signin@syjalo.dev>

* refactor: cache createdTimestamp value

Co-authored-by: Qjuh <76154676+Qjuh@users.noreply.github.com>

* docs: better docs for what's done so far

* feat: add Mixin

* refactor(User): remove bitfield getters and add displayName

* feat(structures): add Connection

* feat(structures): add Channel base

* refactor(Mixin): trace prototype chain, allow construction

* fix(structures): fix mixin behavior

* fix(structures): data optimization call behavior from perf testing

* feat: channel mixins

* chore: update deps

* feat: channels and mixins

* chore: more typeguard tests

* fix: tests and some other issues

* feat: add ChannelWebhookMixin

* fix: more tests

* chore: tests and docs

* chore: docs

* fix: remove unneccessary omitted

* chore: apply code suggestions

* refactor: change how extended invite works

* fix: type imports

* Apply suggestions from code review

Co-authored-by: Almeida <github@almeidx.dev>

* fix: tests

* chore: add jsdoc

* refactor: apply code suggestions

* fix: don't instantiate sub-structures

* fix: don't do null default twice

* chore: use formatters, add _cache

* chore: lockfile

* chore: move MixinTypes to declaratiion file

* fix: tests

* fix: don't include source d.ts files for docs

* feat: bitfields

* feat: more bitfields

* refactor: remove DirectoryChannel structure

* chore: apply suggestions from code review

* chore: remove unused import

* refactor: use symbol for mixin toJSON, remove _ prefix

* chore: apply suggestions from code review

* refactor: remove bitfield casts

* refactor: remove special case for threadchannel types

* fix: apply code review suggestions

* refactor: bitfields always store bigint

* fix: tests

* chore: apply suggestions from code review

* fix: lint

* refactor: conditional structuredClone

* Apply suggestions from code review

Co-authored-by: ckohen <chaikohen@gmail.com>

* fix: code review errors

* fix: lint

* chore: bump dtypes

* Update packages/structures/cliff.toml

Co-authored-by: Jiralite <33201955+Jiralite@users.noreply.github.com>

* docs: link to VideoQualityMode

* chore: typo in comment

* chore: small nits in docs links

* chore: small nits

* docs: forgot one

* chore: update template

* chore: typos and things

* chore: apply suggestions from code review

* fix: tests and typeguards

* chore: don't clone appliedTags

* refactor: use a symbol for patch method

* fix: add missing readonly

* chore: remove todo comment

* refactor: use symbol for clone

* fix: add constraint to DataType

* chore: apply suggestions

* fix: dtypes bump

* chore: fix comment

* chore: add todo comment

* chore: mark bitfield as todo
chore: mark bit field as todo and edit readme

---------

Co-authored-by: ckohen <chaikohen@gmail.com>
Co-authored-by: Synbulat Biishev <signin@syjalo.dev>
Co-authored-by: Almeida <github@almeidx.dev>
Co-authored-by: Jiralite <33201955+Jiralite@users.noreply.github.com>
Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com>
2025-07-12 18:24:30 +00:00

66 lines
2.6 KiB
TypeScript

import { describe, test, expect, beforeEach } from 'vitest';
import { DataTemplatePropertyName, OptimizeDataPropertyName, Structure } from '../src/Structure.js';
import { kData, kPatch } from '../src/utils/symbols.js';
describe('Base Structure', () => {
const data = { test: true, patched: false, removed: true };
let struct: Structure<typeof data>;
beforeEach(() => {
// @ts-expect-error Structure constructor is protected
struct = new Structure(data);
// @ts-expect-error Structure.DataTemplate is protected
Structure.DataTemplate = {};
});
test('Data reference is not identical (clone via Object.assign)', () => {
expect(struct[kData]).not.toBe(data);
expect(struct[kData]).toEqual(data);
});
test('Remove properties via template (constructor)', () => {
// @ts-expect-error Structure.DataTemplate is protected
Structure.DataTemplate = { set removed(_) {} };
// @ts-expect-error Structure constructor is protected
const templatedStruct: Structure<typeof data> = new Structure(data);
expect(templatedStruct[kData].removed).toBe(undefined);
// Setters still exist and pass "in" test unfortunately
expect('removed' in templatedStruct[kData]).toBe(true);
expect(templatedStruct[kData]).toEqual({ test: true, patched: false });
});
test('patch clones data and updates in place', () => {
const dataBefore = struct[kData];
const patched = struct[kPatch]({ patched: true });
expect(patched[kData].patched).toBe(true);
// Patch in place
expect(struct[kData]).toBe(patched[kData]);
// Clones
expect(dataBefore.patched).toBe(false);
expect(dataBefore).not.toBe(patched[kData]);
});
test('Remove properties via template ([kPatch])', () => {
// @ts-expect-error Structure.DataTemplate is protected
Structure.DataTemplate = { set removed(_) {} };
// @ts-expect-error Structure constructor is protected
const templatedStruct: Structure<typeof data> = new Structure(data);
templatedStruct[kPatch]({ removed: false });
expect(templatedStruct[kData].removed).toBe(undefined);
// Setters still exist and pass "in" test unfortunately
expect('removed' in templatedStruct[kData]).toBe(true);
expect(templatedStruct[kData]).toEqual({ test: true, patched: false });
});
test('toJSON clones but retains data equality', () => {
const json = struct.toJSON();
expect(json).not.toBe(data);
expect(json).not.toBe(struct[kData]);
expect(struct[kData]).toEqual(json);
});
test("XPropertyName variable matches the actual property's names", () => {
expect(Structure[DataTemplatePropertyName]).toStrictEqual({});
expect(struct[OptimizeDataPropertyName]).toBeTypeOf('function');
});
});