JavaScript Sets
A JavaScript Set is a collection of unique values.
Each value can only occur once in a Set.
A Set can hold any value of any data type.
Set Methods
Method | Description |
---|---|
new Set() | Creates a new Set |
add() | Adds a new element to the Set |
delete() | Removes an element from a Set |
has() | Returns true if a value exists |
clear() | Removes all elements from a Set |
forEach() | Invokes a callback for each element |
values() | Returns an Iterator with all the values in a Set |
keys() | Same as values() |
entries() | Returns an Iterator with the [value,value] pairs from a Set |
Property | Description |
---|---|
size | Returns the number elements in a Set |
How to Create a Set
You can create a JavaScript Set by:
- Passing an Array to
new Set()
- Create a new Set and use
add()
to add values - Create a new Set and use
add()
to add variables
The new Set() Method
Pass an Array to the new Set()
constructor:
Create a Set and add literal values:
Example
// Create a Set
const letters = new Set();
// Add Values to the Set
letters.add("a");
letters.add("b");
letters.add("c");
Try it Yourself »
Create a Set and add variables:
Example
// Create Variables
const a = "a";
const b = "b";
const c = "c";
// Create a Set
const letters = new Set();
// Add Variables to the Set
letters.add(a);
letters.add(b);
letters.add(c);
Try it Yourself »
The add() Method
If you add equal elements, only the first will be saved:
Example
letters.add("a");
letters.add("b");
letters.add("c");
letters.add("c");
letters.add("c");
letters.add("c");
letters.add("c");
letters.add("c");
Try it Yourself »
The forEach() Method
The forEach()
method invokes a function for each Set element:
Example
// Create a Set
const letters = new Set(["a","b","c"]);
// List all entries
let text = "";
letters.forEach (function(value) {
text += value;
})
Try it Yourself »
The values() Method
The values()
method returns an Iterator object containing all the values in a Set:
Now you can use the Iterator object to access the elements:
Example
// Create an Iterator
const myIterator = letters.values();
// List all Values
let text = "";
for (const entry of myIterator) {
text += entry;
}
Try it Yourself »
The keys() Method
A Set has no keys.
keys()
returns the same as
values()
.
This makes Sets compatible with Maps.
The entries() Method
A Set has no keys.
entries()
returns [value,value] pairs
instead of [key,value] pairs.
This makes Sets compatible with Maps:
Example
// Create an Iterator
const myIterator = letters.entries();
// List all Entries
let text = "";
for (const entry of myIterator) {
text += entry;
}
Try it Yourself »
Sets are Objects
For a Set, typeof
returns object:
typeof letters; // Returns object
Try it Yourself »
For a Set, instanceof Set
returns true:
letters instanceof Set; // Returns true
Try it Yourself »