Iterator.prototype.every()
Baseline
2025
Newly available
Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Phương thức every() của các thực thể Iterator tương tự như Array.prototype.every(): nó trả về false nếu tìm thấy một phần tử không thỏa mãn hàm kiểm tra đã cho. Ngược lại, nếu iterator đã cạn kiệt mà không tìm thấy phần tử như vậy, nó trả về true.
Cú pháp
every(callbackFn)
Tham số
callbackFn-
Hàm thực thi cho mỗi phần tử do iterator tạo ra. Nó nên trả về giá trị truthy để chỉ ra rằng phần tử đã vượt qua bài kiểm tra, và giá trị falsy nếu không. Hàm được gọi với các đối số sau:
Giá trị trả về
true nếu callbackFn trả về giá trị truthy cho mọi phần tử. Ngược lại, false.
Mô tả
every() lặp qua iterator và gọi hàm callbackFn một lần cho mỗi phần tử. Nó trả về false ngay lập tức nếu hàm callback trả về giá trị falsy. Ngược lại, nó lặp đến cuối iterator và trả về true. Nếu every() trả về false, iterator nền được đóng bằng cách gọi phương thức return() của nó.
Ưu điểm chính của các iterator helper so với các phương thức mảng là chúng lười biếng, nghĩa là chúng chỉ tạo ra giá trị tiếp theo khi được yêu cầu. Điều này tránh được tính toán không cần thiết và cũng cho phép chúng được sử dụng với các iterator vô hạn. Với các iterator vô hạn, every() trả về false ngay khi tìm thấy giá trị falsy đầu tiên. Nếu callbackFn luôn trả về giá trị truthy, phương thức không bao giờ trả về.
Ví dụ
>Sử dụng every()
function* fibonacci() {
let current = 1;
let next = 1;
while (true) {
yield current;
[current, next] = [next, current + next];
}
}
const isEven = (x) => x % 2 === 0;
console.log(fibonacci().every(isEven)); // false
const isPositive = (x) => x > 0;
console.log(fibonacci().take(10).every(isPositive)); // true
console.log(fibonacci().every(isPositive)); // Không bao giờ hoàn thành
Gọi every() luôn đóng iterator nền, ngay cả khi phương thức trả về sớm. Iterator không bao giờ bị để lại ở trạng thái nửa chừng.
const seq = fibonacci();
console.log(seq.every(isEven)); // false
console.log(seq.next()); // { value: undefined, done: true }
Đặc điểm kỹ thuật
| Specification |
|---|
| ECMAScript® 2027 Language Specification> # sec-iterator.prototype.every> |