RangeError

Baseline Widely available *

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

* Some parts of this feature may have varying levels of support.

Đối tượng RangeError chỉ ra một lỗi khi một giá trị không nằm trong tập hợp hoặc phạm vi các giá trị được phép.

Mô tả

RangeError được ném ra khi cố gắng truyền một giá trị làm đối số cho một hàm mà không cho phép phạm vi bao gồm giá trị đó.

Điều này có thể xảy ra khi:

truyền một giá trị không phải là một trong các giá trị chuỗi được phép vào String.prototype.normalize(), hoặc
khi cố gắng tạo một mảng có độ dài không hợp lệ bằng constructor Array, hoặc
khi truyền các giá trị xấu vào các phương thức số Number.prototype.toExponential(), Number.prototype.toFixed() hoặc Number.prototype.toPrecision().

RangeError là một serializable object, vì vậy nó có thể được nhân bản với structuredClone() hoặc sao chép giữa các Worker bằng cách sử dụng postMessage().

RangeError là lớp con của Error.

Constructor

RangeError(): Tạo một đối tượng RangeError mới.

Thuộc tính instance

Cũng kế thừa các thuộc tính instance từ lớp cha Error.

Các thuộc tính này được định nghĩa trên RangeError.prototype và được chia sẻ bởi tất cả các instance RangeError.

RangeError.prototype.constructor: Hàm constructor đã tạo ra đối tượng instance. Đối với các instance RangeError, giá trị khởi tạo là constructor RangeError.
RangeError.prototype.name: Đại diện cho tên của loại lỗi. Đối với RangeError.prototype.name, giá trị khởi tạo là "RangeError".

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) {
    // Handle the error
  }
}

Sử dụng RangeError (cho giá trị không phải số)

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) {
    // Handle the error
  }
}