StorageArea.set()
저장소 영역에 하나 이상의 항목을 저장하거나, 있는 항목을 고친다.
이 API로 값을 저장하거나 고치면, storage.onChanged
이벤트가 발생한다.
비동기 함수로 Promise
를 돌려준다.
문법
js
let settingItem = browser.storage.<storageType>.set(
keys // object
)
<storageType>
은 쓰기 가능한 저장소 중의 하나다 — storage.sync
또는 storage.local
.
매개변수
반환값
반환된 Promise
는 동작이 성공하면 아무런 인수없이 완료를 수행하고, 실패하면 에러 문장과 함께 거부를 수행한다.
브라우저 호환성
BCD tables only load in the browser
예제
js
function setItem() {
console.log("OK");
}
function gotKitten(item) {
console.log(`${item.kitten.name} has ${item.kitten.eyeCount} eyes`);
}
function gotMonster(item) {
console.log(`${item.monster.name} has ${item.monster.eyeCount} eyes`);
}
function onError(error) {
console.log(error);
}
// define 2 objects
var monster = {
name: "Kraken",
tentacles: true,
eyeCount: 10,
};
var kitten = {
name: "Moggy",
tentacles: false,
eyeCount: 2,
};
// store the objects
browser.storage.local.set({ kitten, monster }).then(setItem, onError);
browser.storage.local.get("kitten").then(gotKitten, onError);
browser.storage.local.get("monster").then(gotMonster, onError);
참고: AcknowledgementsThis API is based on Chromium's
chrome.storage
API. This documentation is derived fromstorage.json
in the Chromium code.