RangeError() 생성자
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015년 7월.
RangeError() 생성자는 어떤 값이 집합에 없거나
허용되는 범위가 아닐 때 발생하는 오류를 생성합니다
구문
js
new RangeError()
new RangeError(message)
new RangeError(message, options)
new RangeError(message, fileName)
new RangeError(message, fileName, lineNumber)
RangeError()
RangeError(message)
RangeError(message, options)
RangeError(message, fileName)
RangeError(message, fileName, lineNumber)
참고 :
RangeError()는 new와 함께 호출하거나 혹은 new 없이 호출할 수 있습니다. 두 방법 모두 새로운 RangeError 인스턴스를 생성합니다.
매개변수
messageOptional-
사람이 읽을 수 있는 오류에 대한 설명
optionsOptional-
다음의 속성을 가지는 객체.
causeOptional-
오류의 특정 원인을 가리키는 속성. 오류를 잡아서 좀 더 상세하거나 유용한 오류 메시지와 함께 예외를 다시 발생시킬 때 이 속성을 원래 오류를 전달하는데 사용할 수 있습니다.
fileNameOptional 비표준-
예외가 발생한 코드를 담고 있는 파일 이름
lineNumberOptional 비표준-
예외가 발생한 코드의 줄 수
예제
>RangeError 사용하기(숫자 값일 경우)
js
function check(n) {
if (!(n >= -500 && n <= 500)) {
throw new RangeError("The argument must be between -500 and 500.");
}
}
try {
check(2000);
} catch (error) {
if (error instanceof RangeError) {
// 오류 처리
}
}
RangeError 사용하기 (숫자 값이 아닐 경우)
js
function check(value) {
if (!["apple", "banana", "carrot"].includes(value)) {
throw new RangeError(
'The argument must be an "apple", "banana", or "carrot".',
);
}
}
try {
check("cabbage");
} catch (error) {
if (error instanceof RangeError) {
// 오류 처리
}
}
명세서
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-nativeerror-constructors> |