SharedStorage: append() method
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Phương thức append() của giao diện SharedStorage nối thêm một chuỗi vào giá trị của một cặp key-value hiện có trong bộ lưu trữ chia sẻ của nguồn gốc hiện tại.
Cú pháp
append(key, value)
Tham số
key-
Một chuỗi đại diện cho key của cặp key-value mà bạn muốn nối thêm giá trị.
value-
Một chuỗi bạn muốn nối thêm vào giá trị hiện có của cặp key-value.
Note:
Nếu key được chỉ định không tìm thấy trong bộ lưu trữ chia sẻ, thao tác append() tương đương với set(), tức là một cặp key-value mới với key được chỉ định sẽ được thêm vào bộ lưu trữ chia sẻ.
Giá trị trả về
Một Promise thực hiện với undefined.
Ngoại lệ
Promisetừ chối vớiTypeErrornếu:- Mục nhập được nối thêm không được lưu trữ thành công trong cơ sở dữ liệu do bộ lưu trữ chia sẻ không khả dụng (ví dụ: bị tắt bởi cài đặt trình duyệt).
keyvà/hoặcvaluevượt quá độ dài tối đa do trình duyệt xác định.- Trang gọi không có Shared Storage API được bao gồm trong quy trình đăng ký privacy sandbox thành công.
- Trong trường hợp
WorkletSharedStorage,Promisetừ chối vớiTypeErrornếu module worklet chưa được thêm bằngSharedStorageWorklet.addModule().
Note:
Trong trường hợp WindowSharedStorage, nếu thao tác append() không ghi thành công vào cơ sở dữ liệu vì lý do khác ngoài bộ lưu trữ chia sẻ không khả dụng, không có lỗi nào được ném ra, thao tác vẫn thực hiện với undefined.
Ví dụ
window.sharedStorage
.append("integer-list", ",9")
.then(() => console.log("Value appended to integer list"));
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Shared Storage API # dom-sharedstorage-append |