WeakSet.prototype.add()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015년 9월.

WeakSet 인스턴스의 add() 메서드는 이 WeakSet의 끝에 새로운 객체를 추가합니다.

시도해 보기

const weakset1 = new WeakSet();
const object1 = {};

weakset1.add(object1);
console.log(weakset1.has(object1));
// Expected output: true

try {
  weakset1.add(1);
} catch (error) {
  console.log(error);
  // Expected output (Chrome): TypeError: Invalid value used in weak set
  // Expected output (Firefox): TypeError: WeakSet value must be an object, got 1
  // Expected output (Safari): TypeError: Attempted to add a non-object key to a WeakSet
}

구문

add(value)

매개변수

value

반드시 객체이거나 등록되지 않은 심볼이어야 합니다. WeakSet 컬렉션에 추가될 값입니다.

반환 값

WeakSet 객체.

예외

TypeError

value가 객체가 아니거나 등록되지 않은 심볼일 경우 발생합니다.

예제

add 사용하기

js
const ws = new WeakSet();

ws.add(window); // window 객체를 WeakSet에 추가

ws.has(window); // true

// WeakSet는 인수로 오직 객체만 받습니다
ws.add(1);
// Chrome 에서는 "TypeError: Invalid value used in weak set"라는 결과가,
// Firefox 에서는 "TypeError: 1 is not a non-null object" 라는 결과가 나옵니다

명세서

Specification

ECMAScript® 2027 Language Specification
# sec-weakset.prototype.add

브라우저 호환성

Enable JavaScript to view this browser compatibility table.

같이 보기

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025년 2월 11일 by MDN contributors.

View this page on GitHub • Report a problem with this content

표준 내장 객체
WeakSet
생성자
1. WeakSet() 생성자
인스턴스 메서드
상속
Object/Function
정적 메서드
정적 속성
인스턴스 메서드
인스턴스 속성
1. Object.prototype.__proto__
2. Object.prototype.constructor

WeakSet.prototype.add()

In this article

Help improve MDN