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

CKTIS / JavaScript

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

Ако входните елементи не се променят по време на извикването, symmetricDifference() връща нов 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.symmetricDifference(other)

Ако входните елементи не се променят по време на извикването, a.symmetricDifference(b) връща нов Set със стойностите, които принадлежат на a или b, но не и на двете. При аргумент, подобен на множество, за негови елементи се приемат стойностите, предоставени чрез keys(). За разлика от едностранната разлика, симетричната разлика включва елементите, които се срещат само от едната или само от другата страна. Самият метод не променя входните множества.

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

Алгоритъмът копира данните на получателя преди първата стъпка на итератора на аргумента. За всеки ключ, върнат от итератора, обаче проверява дали той се съдържа в получателя в този момент, а не в копието. Ако итераторът промени съдържанието на получателя, резултатът не е непременно симетричната разлика между върнатите ключове и началното или крайното съдържание на получателя.

При непроменени входни данни резултатът запазва първо реда на стойностите, които се срещат само в получателя, а след това реда на стойностите, които се срещат само в other, според предоставеното от keys(). Сравняването следва SameValueZero: NaN съвпада с NaN, +0 и -0 са еквивалентни, а обектите се сравняват по идентичност, а не по съдържание.

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

Примери

const a = new Set([1, 2, 3]);
const b = new Set([3, 4, 2, 5]);
const result = a.symmetricDifference(b);

console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...a]));
console.log(JSON.stringify([...b]));

Резултат

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

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

Източници