База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Set.prototype.difference — разлика на множества

Методът difference() връща нов Set с елементите на получаващото множество, които липсват в другото множество. Запазва реда им и сам по себе си не променя входните множества.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

set.difference(other)

Set.prototype.difference изчислява разлика на множества: a.difference(b) съдържа елементите на a, които липсват в b. Редът на операндите има значение — това не е симетрична разлика. Резултатът е нов Set, който запазва реда на вмъкване на останалите елементи на a; самата операция не променя входните множества.

Получателят this трябва да е действителен обект Set. Аргументът other може да е множество или обект, подобен на множество: трябва да предоставя валиден size и извикваеми методи has() и keys(). Map изпълнява този протокол и се сравняват ключовете ѝ. Само това, че е итерируем, не е достатъчно: първо подайте масива на new Set(...).

При обикновените множества равенството следва SameValueZero: NaN съответства на NaN, +0 и -0 са еквивалентни, а обектите се сравняват по идентичност, не по съдържание. В зависимост от размерите алгоритъмът използва other.has() или обхожда other.keys(). Затова персонализираните методи и гетъри могат да имат странични ефекти; не приемайте, че редът на извикванията им е независим от размера.

Методът е част от ECMAScript 2025, а не от Web APIs. При внедряване проверете typeof Set.prototype.difference === "function" в целевата среда. Спецификацията не е таблица за поддръжка от браузърите, а наличието на Node 24 в хранилище не доказва поддръжка в браузърите.

Примери

const available = new Set([3, 1, 2]);
const reserved = new Set([1, 4]);
const remaining = available.difference(reserved);

console.log(JSON.stringify([...remaining]));
console.log(JSON.stringify([...available]));
console.log(JSON.stringify([...reserved]));

Резултат

[3,2]
[3,1,2]
[1,4]

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници