W3cubDocs

/JavaScript

Set.prototype.union()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The union() method of Set instances takes a set and returns a new set containing elements which are in either or both of this set and the given set.

Syntax

js
union(other)

Parameters

other

A Set object, or set-like object.

Return value

A new Set object containing elements which are in either or both of this set and the other set.

Description

In mathematical notation, union is defined as:

A B = { x x A or x B } A\cup B = {x\midx\in A\text{ or }x\in B}

And using Venn diagram:

A Venn diagram where two circles overlap. The symmetric difference of A and B is the region contained by either or both circles.

union() accepts set-like objects as the other parameter. It requires this to be an actual Set instance, because it directly retrieves the underlying data stored in this without invoking any user code. Then, it iterates over other by calling its keys() method, and constructs a new set with all elements in this, followed by all elements in other that are not present in this.

The order of elements in the returned set is first those in this followed by those in other.

Examples

Using union()

The following example computes the union between the set of even numbers (<10) and the set of perfect squares (<10). The result is the set of numbers that are either even or a perfect square, or both.

js
const evens = new Set([2, 4, 6, 8]);
const squares = new Set([1, 4, 9]);
console.log(evens.union(squares)); // Set(6) { 1, 2, 4, 6, 8, 9 }

Specifications

Browser compatibility

Desktop Mobile Server
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android Deno Node.js
union No No preview No 17 No No No 17 No No No No

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set/union