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

CKTIS / JavaScript

Set.prototype.intersection — общи стойности на множества

Методът intersection(other) връща нов Set със стойностите, които присъстват и в двете колекции. Редът на резултата зависи от размера на операндите; other може да бъде и обект с интерфейс, подобен на 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.intersection(other)

set.intersection(other) изчислява сечение: връща нов Set със стойностите, които присъстват и в двете колекции. При обикновени множества не променя нито един от входовете. Методът е част от ECMAScript 2025, а не API на браузър. Самата спецификация не доказва поддръжка в конкретен браузър; преди употреба проверете typeof Set.prototype.intersection === "function". Наличието на Node 24 в хранилище не доказва поддръжка в браузърите.

Получателят set трябва да е действителен обект Set. Аргументът other може да бъде множество или обект, подобен на множество: трябва да предоставя валиден size и извикваеми методи has и keys. Подходящ е и Map, чиито ключове се третират като елементи. Самата итеративност не е достатъчна: обикновен масив не реализира този интерфейс. Невалиден получател предизвиква TypeError.

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

В примера right е по-малко, затова редът на резултата е [3,2], а размерите на входовете остават непроменени. Персонализирани getter-и и методите has и keys на other могат да изпълняват код, да променят данни или да предизвикват изключения; в такъв случай не приемайте, че операцията няма странични ефекти.

Примери

const left = new Set([1, 2, 3, 4]);
const right = new Set([3, 2]);
const common = left.intersection(right);

console.log(JSON.stringify([...common]));
console.log(left.size, right.size);

Резултат

[3,2]
4 2

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

Източници