DisposableStack.prototype.dispose()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức dispose() của các instance DisposableStack hủy ngăn xếp này bằng cách gọi tất cả các disposer đã đăng ký theo thứ tự ngược lại với thứ tự đăng ký. Nếu ngăn xếp đã bị hủy, phương thức này không làm gì cả.
Nó thực hiện hành động tương tự như using disposer = new DisposableStack() khi thoát khỏi phạm vi. Có thể sử dụng nếu bạn cần dọn dẹp tại một thời điểm khác ngoài lúc thoát phạm vi.
Cú pháp
dispose()
Tham số
Không có.
Giá trị trả về
Không có (undefined).
Ngoại lệ
SuppressedError-
Ném ra nếu nhiều disposer trong ngăn xếp cùng ném lỗi. Nếu chỉ một lỗi được ném, lỗi đó sẽ được ném lại nguyên vẹn. Nếu không, với mỗi lỗi phát sinh thêm, một
SuppressedErrormới sẽ được tạo, với lỗi gốc là thuộc tínhsuppressedvà lỗi mới là thuộc tínherror.
Ví dụ
Hủy một ngăn xếp
Ở đây chúng ta đẩy ba disposer vào ngăn xếp, sử dụng các phương thức use(), adopt(), và defer(). Khi dispose() được gọi, các disposer sẽ được gọi theo thứ tự ngược lại với thứ tự đăng ký.
Lưu ý rằng thông thường bạn không cần gọi dispose() thủ công. Hãy khai báo ngăn xếp với using, và phương thức [Symbol.dispose]() của nó sẽ tự động được gọi khi ngăn xếp ra khỏi phạm vi.
class Resource {
dispose() {
console.log("Resource disposed");
}
[Symbol.dispose]() {
console.log("Resource disposed via Symbol.dispose");
}
}
{
const disposer = new DisposableStack();
const resource = disposer.use(new Resource());
const resource2 = disposer.adopt(new Resource(), (resource) =>
resource.dispose(),
);
disposer.defer(() => console.log("Deferred disposer"));
disposer.dispose();
// Logs in order:
// Deferred disposer
// Resource disposed
// Resource disposed via Symbol.dispose
}
Đặc tả
| Specification |
|---|
| ECMAScript Async Explicit Resource Management # sec-disposablestack.prototype.dispose |