หน้านี้ได้รับการแปลโดย Cloud Translation API

chrome.storage

คำอธิบาย

ใช้ chrome.storage API เพื่อจัดเก็บ เรียกข้อมูล และติดตามการเปลี่ยนแปลงในข้อมูลผู้ใช้

สิทธิ์

storage

ภาพรวม

Storage API มอบวิธีที่เจาะจงของส่วนขยายในการคงข้อมูลผู้ใช้และสถานะ ซึ่งคล้ายกับ Storage API ของแพลตฟอร์มเว็บ (IndexedDB และ Storage) แต่ออกแบบมาเพื่อตอบสนองความต้องการพื้นที่เก็บข้อมูลของส่วนขยาย ฟีเจอร์หลักๆ มีดังนี้

บริบทส่วนขยายทั้งหมด รวมถึง Service Worker สำหรับส่วนขยายและสคริปต์เนื้อหาจะมีสิทธิ์เข้าถึง Storage API
ระบบจะจัดเก็บค่าที่ซีเรียลไลซ์ได้ของ JSON เป็นพร็อพเพอร์ตี้ออบเจ็กต์
Storage API ทำงานไม่พร้อมกันกับการดำเนินการอ่านและเขียนจำนวนมาก
แม้ว่าผู้ใช้จะล้างแคชและประวัติการท่องเว็บแล้ว แต่ข้อมูลจะยังคงอยู่
การตั้งค่าที่เก็บไว้จะยังคงอยู่ แม้จะใช้แยกโหมดไม่ระบุตัวตนอยู่
มีพื้นที่เก็บข้อมูลที่มีการจัดการแบบอ่านอย่างเดียวสุดพิเศษสำหรับนโยบายขององค์กร

แม้ว่าส่วนขยายจะใช้อินเทอร์เฟซ [Storage][mdn-storage] (เข้าถึงได้จาก window.localStorage) ในบางบริบท (ป๊อปอัปและหน้า HTML อื่นๆ) ได้ แต่เราไม่แนะนําด้วยเหตุผลต่อไปนี้

Service Worker ของส่วนขยายเข้าถึง Storage ไม่ได้
สคริปต์เนื้อหาจะแชร์พื้นที่เก็บข้อมูลกับหน้าโฮสต์
ข้อมูลที่บันทึกโดยใช้อินเทอร์เฟซ Storage จะหายไปเมื่อผู้ใช้ล้างประวัติการท่องเว็บ

วิธีย้ายข้อมูลจาก Web Storage API ไปยัง Extension Storage API จาก Service Worker

สร้างเอกสารนอกหน้าจอที่มีกิจวัตร Conversion และเครื่องจัดการ [onMessage][on-message]
เพิ่มกิจวัตร Conversion ลงในเอกสารที่อยู่นอกหน้าจอ
ในโปรแกรมทำงานของบริการส่วนขยาย ให้ตรวจสอบ chrome.storage สำหรับข้อมูลของคุณ
หากไม่พบข้อมูล ให้[สร้าง][create-offscreen] เอกสารนอกหน้าจอแล้วเรียกใช้ [sendMessage()][send-message] เพื่อเริ่มกิจวัตร Conversion
เรียกใช้กิจวัตรการเปลี่ยนรูปแบบภายในตัวแฮนเดิล onMessage ของเอกสารที่อยู่นอกหน้าจอ

นอกจากนี้ ยังมีความแตกต่างเล็กน้อยเกี่ยวกับวิธีการทำงานของ Web Storage API ในส่วนขยาย ดูข้อมูลเพิ่มเติมใน บทความ [พื้นที่เก็บข้อมูลและคุกกี้][พื้นที่เก็บข้อมูลและคุกกี้]

พื้นที่เก็บข้อมูล

Storage API แบ่งออกเป็น 4 กลุ่ม ("พื้นที่เก็บข้อมูล") ดังนี้

storage.local: ระบบจะจัดเก็บข้อมูลไว้ในเครื่อง ซึ่งจะล้างออกเมื่อนําส่วนขยายออก ขีดจำกัดโควต้าจะอยู่ที่ประมาณ 10 MB แต่เพิ่มได้ด้วยการขอสิทธิ์ "unlimitedStorage" ลองใช้เพื่อจัดเก็บข้อมูลจำนวนมากขึ้น

storage.sync: หากเปิดการซิงค์ไว้ ข้อมูลจะซิงค์กับเบราว์เซอร์ Chrome ทั้งหมดที่ผู้ใช้เข้าสู่ระบบ หากปิดใช้ จะมีลักษณะการทำงานเหมือน storage.local Chrome จะจัดเก็บข้อมูลไว้ในเครื่องเมื่อเบราว์เซอร์ออฟไลน์ และจะซิงค์ต่อเมื่อกลับมาออนไลน์ โดยขีดจำกัดโควต้าจะอยู่ที่ประมาณ 100 KB หรือ 8 KB ต่อรายการ พิจารณาใช้ฟีเจอร์นี้เพื่อเก็บการตั้งค่าผู้ใช้ในเบราว์เซอร์ที่ซิงค์ไว้

คำเตือน: พื้นที่เก็บข้อมูลในเครื่องและการซิงค์ไม่ควรจัดเก็บข้อมูลที่เป็นความลับของผู้ใช้เนื่องจากไม่มีการเข้ารหัส เมื่อทำงานกับข้อมูลที่ละเอียดอ่อน โปรดพิจารณาใช้พื้นที่เก็บข้อมูลขนาด session เพื่อเก็บรักษาค่าไว้ในหน่วยความจำจนกว่าเบราว์เซอร์จะปิดลง

storage.session: เก็บข้อมูลไว้ในหน่วยความจําตลอดระยะเวลาของเซสชันเบราว์เซอร์ โดยค่าเริ่มต้น จะไม่มีการแสดงสคริปต์เนื้อหา แต่คุณเปลี่ยนลักษณะการทํางานนี้ได้โดยการตั้งค่า chrome.storage.session.setAccessLevel() โดยขีดจำกัดโควต้าจะอยู่ที่ประมาณ 10 MB ลองใช้เพื่อจัดเก็บตัวแปรส่วนกลางในรันไทม์ของ Service Worker

storage.managed: ผู้ดูแลระบบสามารถใช้สคีมาและนโยบายขององค์กรเพื่อกำหนดการตั้งค่าของส่วนขยายที่รองรับในสภาพแวดล้อมที่มีการจัดการ พื้นที่เก็บข้อมูลนี้เป็นแบบอ่านอย่างเดียว

ไฟล์ Manifest

หากต้องการใช้ Storage API ให้ประกาศสิทธิ์ "storage" ในไฟล์ Manifest ของส่วนขยาย เช่น

{
  "name": "My extension",
  ...
  "permissions": [
    "storage"
  ],
  ...
}

การใช้งาน

ตัวอย่างต่อไปนี้แสดงพื้นที่เก็บข้อมูล local, sync และ session

storage.local

chrome.storage.local.set({ key: value }).then(() => {
  console.log("Value is set");
});

chrome.storage.local.get(["key"]).then((result) => {
  console.log("Value currently is " + result.key);
});

storage.sync

chrome.storage.sync.set({ key: value }).then(() => {
  console.log("Value is set");
});

chrome.storage.sync.get(["key"]).then((result) => {
  console.log("Value currently is " + result.key);
});

storage.session

chrome.storage.session.set({ key: value }).then(() => {
  console.log("Value was set");
});

chrome.storage.session.get(["key"]).then((result) => {
  console.log("Value currently is " + result.key);
});

ดูข้อมูลเพิ่มเติมเกี่ยวกับพื้นที่เก็บข้อมูลของ managed ได้ที่ไฟล์ Manifest สำหรับพื้นที่เก็บข้อมูล

ขีดจำกัดพื้นที่เก็บข้อมูลและการควบคุม

อย่าคิดว่าการเพิ่มลงใน Storage API คือการใส่สิ่งต่างๆ ลงในรถบรรทุกขนาดใหญ่ คิดว่าการเพิ่มไปยัง ให้เหมือนการใส่ข้อมูลลงในท่อ ท่ออาจมีวัสดุอยู่ภายในและอาจเต็มแล้ว โปรดทราบว่าระหว่างที่คุณเพิ่มลงในพื้นที่เก็บข้อมูลกับเวลาที่บันทึกจริงจะมีเวลาหน่วงเสมอ

โปรดดูรายละเอียดเกี่ยวกับขีดจำกัดของพื้นที่เก็บข้อมูลและสิ่งที่จะเกิดขึ้นเมื่อใช้พื้นที่เก็บข้อมูลเกินขีดจำกัด โปรดดูข้อมูลโควต้าของ sync, local และ session

กรณีการใช้งาน

ส่วนต่อไปนี้จะแสดงกรณีการใช้งานทั่วไปสำหรับ Storage API

การตอบสนองแบบซิงค์กับการอัปเดตพื้นที่เก็บข้อมูล

หากต้องการติดตามการเปลี่ยนแปลงที่เกิดขึ้นกับพื้นที่เก็บข้อมูล ให้เพิ่ม Listener ลงในเหตุการณ์ onChanged ของรายการ เมื่อมีการเปลี่ยนแปลงใดๆ ในพื้นที่เก็บข้อมูล เหตุการณ์นั้นจะเริ่มทำงาน โค้ดตัวอย่างจะรับการเปลี่ยนแปลงต่อไปนี้

background.js:

chrome.storage.onChanged.addListener((changes, namespace) => {
  for (let [key, { oldValue, newValue }] of Object.entries(changes)) {
    console.log(
      `Storage key "${key}" in namespace "${namespace}" changed.`,
      `Old value was "${oldValue}", new value is "${newValue}".`
    );
  }
});

เรานำความคิดนี้ไปต่อยอดได้ ในตัวอย่างนี้ เรามีหน้าตัวเลือก อนุญาตให้ผู้ใช้สลับ "โหมดแก้ไขข้อบกพร่อง" (การติดตั้งใช้งานไม่ได้แสดงที่นี่) หน้าตัวเลือกจะบันทึกการตั้งค่าใหม่ลงใน storage.sync ทันที และ Service Worker จะใช้ storage.onChanged เพื่อใช้การตั้งค่าโดยเร็วที่สุด

options.html:

<!-- type="module" allows you to use top level await -->
<script defer src="options.js" type="module"></script>
<form id="optionsForm">
  <label for="debug">
    <input type="checkbox" name="debug" id="debug">
    Enable debug mode
  </label>
</form>

options.js:

// In-page cache of the user's options
const options = {};
const optionsForm = document.getElementById("optionsForm");

// Immediately persist options changes
optionsForm.debug.addEventListener("change", (event) => {
  options.debug = event.target.checked;
  chrome.storage.sync.set({ options });
});

// Initialize the form with the user's option settings
const data = await chrome.storage.sync.get("options");
Object.assign(options, data.options);
optionsForm.debug.checked = Boolean(options.debug);

background.js:

function setDebugMode() { /* ... */ }

// Watch for changes to the user's options & apply them
chrome.storage.onChanged.addListener((changes, area) => {
  if (area === 'sync' && changes.options?.newValue) {
    const debugMode = Boolean(changes.options.newValue.debug);
    console.log('enable debug mode?', debugMode);
    setDebugMode(debugMode);
  }
});

การโหลดล่วงหน้าแบบไม่พร้อมกันจากพื้นที่เก็บข้อมูล

เนื่องจาก Service Worker ไม่ได้ทำงานอยู่เสมอ ในบางครั้งส่วนขยาย Manifest V3 จึงต้องโหลดข้อมูลจากพื้นที่เก็บข้อมูลแบบไม่พร้อมกันก่อนที่จะเรียกใช้ตัวแฮนเดิลเหตุการณ์ วิธีการคือ ข้อมูลโค้ดต่อไปนี้ใช้เครื่องจัดการเหตุการณ์ action.onClicked แบบไม่พร้อมกันที่รอ storageCache ที่จะใส่ค่าไว้ทั่วโลกก่อนดำเนินการเชิงตรรกะ

background.js:

// Where we will expose all the data we retrieve from storage.sync.
const storageCache = { count: 0 };
// Asynchronously retrieve data from storage.sync, then cache it.
const initStorageCache = chrome.storage.sync.get().then((items) => {
  // Copy the data retrieved from storage into storageCache.
  Object.assign(storageCache, items);
});

chrome.action.onClicked.addListener(async (tab) => {
  try {
    await initStorageCache;
  } catch (e) {
    // Handle error that occurred during storage initialization.
  }

  // Normal action handler logic.
  storageCache.count++;
  storageCache.lastTabId = tab.id;
  chrome.storage.sync.set(storageCache);
});

ตัวอย่างส่วนขยาย

หากต้องการดูการสาธิตอื่นๆ ของ Storage API ให้สำรวจตัวอย่างต่อไปนี้

ประเภท

AccessLevel

Chrome 102 ขึ้นไป

ระดับการเข้าถึงของพื้นที่เก็บข้อมูล

ค่าแจกแจง

"TRUSTED_CONTEXTS"
ระบุบริบทที่มีที่มาจากส่วนขยายเอง

"TRUSTED_AND_UNTRUSTED_CONTEXTS"
ระบุบริบทที่มาจากภายนอกส่วนขยาย

StorageArea

พร็อพเพอร์ตี้

onChanged

Event<functionvoidvoid>

Chrome 73 ขึ้นไป

เรียกใช้เมื่อมีการเปลี่ยนแปลงรายการอย่างน้อย 1 รายการ

ฟังก์ชัน onChanged.addListener มีลักษณะดังนี้
```
(callback: function) => {...}
```
- Callback
  
  ฟังก์ชัน
  
  พารามิเตอร์ callback มีลักษณะดังนี้
```
(changes: object) => void
```
  - การเปลี่ยนแปลง
    
    ออบเจ็กต์
ล้าง

เป็นโมฆะ

สัญญา

นำรายการทั้งหมดออกจากพื้นที่เก็บข้อมูล

ฟังก์ชัน clear มีรูปแบบดังนี้
```
(callback?: function) => {...}
```
- Callback
  
  ไม่บังคับ
  
  พารามิเตอร์ callback มีลักษณะดังนี้
```
() => void
```
- returns
  Promise<void>
  
  Chrome เวอร์ชัน 88 ขึ้นไป
  
  ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ
รับ

โมฆะ

สัญญา

รับรายการอย่างน้อย 1 รายการจากพื้นที่เก็บข้อมูล

ฟังก์ชัน get มีลักษณะดังนี้
```
(keys?: string | string[] | object, callback?: function) => {...}
```
- กุญแจ
  
  string | string[] | ออบเจ็กต์ไม่บังคับ
  
  คีย์เดียวสำหรับรับ รายการคีย์ที่จะรับ หรือพจนานุกรมที่ระบุค่าเริ่มต้น (ดูคำอธิบายออบเจ็กต์) รายการหรือออบเจ็กต์ที่ว่างเปล่าจะแสดงออบเจ็กต์ผลลัพธ์ที่ว่างเปล่า ส่ง null เพื่อรับเนื้อหาทั้งหมดของพื้นที่เก็บข้อมูล
- Callback
  
  ไม่บังคับ
  
  พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(items: object) => void
```
  - รายการ
    
    ออบเจ็กต์
    
    ออบเจ็กต์ที่มีรายการในการแมปคีย์-ค่า
- returns
  คำสัญญา<วัตถุ>
  
  Chrome 88 ขึ้นไป
  
  ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ
getBytesInUse

เป็นโมฆะ

สัญญา

รับปริมาณพื้นที่ (เป็นไบต์) ที่รายการอย่างน้อย 1 รายการใช้อยู่

ฟังก์ชัน getBytesInUse มีรูปแบบดังนี้
```
(keys?: string | string[], callback?: function) => {...}
```
- กุญแจ
  
  string | string[] ไม่บังคับ
  
  คีย์เดียวหรือรายการคีย์เพื่อดูการใช้งานทั้งหมด รายการว่างจะแสดงผลเป็น 0 ส่ง null เพื่อดูการใช้งานพื้นที่เก็บข้อมูลทั้งหมด
- Callback
  
  ไม่บังคับ
  
  พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(bytesInUse: number) => void
```
  - bytesInUse
    
    ตัวเลข
    
    ปริมาณพื้นที่ที่ใช้ในพื้นที่เก็บข้อมูลในหน่วยไบต์
- returns
  คำมั่นสัญญา<จำนวน>
  
  Chrome เวอร์ชัน 88 ขึ้นไป
  
  ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ
getKeys

โมฆะ

สัญญา Chrome 130 ขึ้นไป

ดึงคีย์ทั้งหมดจากพื้นที่เก็บข้อมูล

ฟังก์ชัน getKeys มีลักษณะดังนี้
```
(callback?: function) => {...}
```
- Callback
  
  ไม่บังคับ
  
  พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(keys: string[]) => void
```
  - กุญแจ
    
    string[]
    
    อาร์เรย์ที่มีคีย์ที่อ่านจากพื้นที่เก็บข้อมูล
- returns
  Promise<string[]>
  
  ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ
นำข้อมูลออก

โมฆะ

สัญญา

นำรายการอย่างน้อย 1 รายการออกจากพื้นที่เก็บข้อมูล

ฟังก์ชัน remove มีลักษณะดังนี้
```
(keys: string | string[], callback?: function) => {...}
```
- กุญแจ
  
  string | string[]
  
  คีย์เดียวหรือชุดคีย์สำหรับรายการต่างๆ ที่จะนำออก
- Callback
  
  ไม่บังคับ
  
  พารามิเตอร์ callback มีลักษณะดังนี้
```
() => void
```
- returns
  Promise<void>
  
  Chrome เวอร์ชัน 88 ขึ้นไป
  
  ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ
ตั้งค่า

โมฆะ

สัญญา

ตั้งค่าหลายรายการ

ฟังก์ชัน set มีลักษณะดังนี้
```
(items: object, callback?: function) => {...}
```
- รายการ
  
  ออบเจ็กต์
  
  ออบเจ็กต์ที่ให้คู่คีย์/ค่าแต่ละคู่สำหรับอัปเดตพื้นที่เก็บข้อมูล คู่คีย์/ค่าอื่นๆ ในพื้นที่เก็บข้อมูลจะไม่ได้รับผลกระทบ
  
  ค่าพื้นฐาน เช่น ตัวเลข จะจัดรูปแบบตามปกติ โดยทั่วไปแล้วค่าที่มี typeof "object" และ "function" จะเป็นแบบอนุกรมเป็น {} ยกเว้น Array (ทำให้เป็นอนุกรมตามที่คาดไว้), Date และ Regex (ทำให้เป็นอนุกรมโดยใช้การแทน String)
- Callback
  
  ไม่บังคับ
  
  พารามิเตอร์ callback มีลักษณะดังนี้
```
() => void
```
- returns
  Promise<void>
  
  Chrome 88 ขึ้นไป
  
  Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
setAccessLevel

โมฆะ

สัญญา Chrome 102 ขึ้นไป

กำหนดระดับการเข้าถึงที่ต้องการสำหรับพื้นที่เก็บข้อมูล ค่าเริ่มต้นจะเป็นบริบทที่เชื่อถือได้เท่านั้น

ฟังก์ชัน setAccessLevel มีลักษณะดังนี้
```
(accessOptions: object, callback?: function) => {...}
```
- accessOptions
  
  ออบเจ็กต์
  - accessLevel
    
    AccessLevel
    
    ระดับการเข้าถึงของพื้นที่เก็บข้อมูล
- Callback
  
  ไม่บังคับ
  
  พารามิเตอร์ callback มีลักษณะดังนี้
```
() => void
```
- returns
  คำสัญญา<โมฆะ>
  
  Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

StorageChange

พร็อพเพอร์ตี้

newValue

ใดก็ได้ไม่บังคับ

ค่าใหม่ของรายการ หากมี
oldValue

ใดก็ได้ไม่บังคับ

ค่าเดิมของรายการ หากมีค่าเก่า

พร็อพเพอร์ตี้

local

รายการในพื้นที่เก็บข้อมูลของ local จะเป็นข้อมูลในเครื่องของแต่ละเครื่อง

ประเภท

StorageArea และ ออบเจ็กต์

พร็อพเพอร์ตี้

QUOTA_BYTES

10485760

จำนวนข้อมูลสูงสุด (เป็นไบต์) ที่สามารถจัดเก็บไว้ในพื้นที่เก็บข้อมูลในเครื่อง ซึ่งวัดโดยการกำหนดสตริง JSON ของทุกค่าบวกความยาวของคีย์ทุกคีย์ ระบบจะละเว้นค่านี้หากส่วนขยายมีสิทธิ์ unlimitedStorage การอัปเดตที่จะทำให้เกินขีดจำกัดนี้จะดำเนินการไม่สำเร็จทันที และจะตั้งค่า runtime.lastError เมื่อใช้ Callback หรือ Promise ที่ถูกปฏิเสธหากใช้ async/await

managed

รายการในพื้นที่เก็บข้อมูล managed กำหนดโดยนโยบายขององค์กรที่ผู้ดูแลระบบโดเมนกำหนดค่าไว้ และเป็นแบบอ่านอย่างเดียวสำหรับส่วนขยาย การพยายามแก้ไขเนมสเปซนี้จะทำให้เกิดข้อผิดพลาด โปรดดูข้อมูลเกี่ยวกับการกำหนดค่านโยบายที่หัวข้อไฟล์ Manifest สำหรับพื้นที่เก็บข้อมูล

ประเภท

StorageArea

session

Chrome 102 ขึ้นไป MV3 ขึ้นไป

รายการในพื้นที่เก็บข้อมูล session จะจัดเก็บไว้ในหน่วยความจำและจะไม่เก็บถาวรไว้ในดิสก์

ประเภท

StorageArea และออบเจ็กต์

พร็อพเพอร์ตี้

QUOTA_BYTES

10485760

จํานวนข้อมูลสูงสุด (เป็นไบต์) ที่เก็บไว้ในหน่วยความจําได้ ซึ่งวัดจากการประมาณการใช้หน่วยความจําที่จัดสรรแบบไดนามิกของค่าและคีย์ทุกรายการ การอัปเดตที่จะทำให้เกินขีดจำกัดนี้จะดำเนินการไม่สำเร็จทันที และจะตั้งค่า runtime.lastError เมื่อใช้ Callback หรือเมื่อมีการปฏิเสธ Promise

sync

ระบบจะซิงค์รายการในพื้นที่เก็บข้อมูล sync โดยใช้การซิงค์ของ Chrome

ประเภท

StorageArea และออบเจ็กต์

พร็อพเพอร์ตี้

MAX_ITEMS

512

จำนวนรายการสูงสุดที่สามารถจัดเก็บในพื้นที่เก็บข้อมูลการซิงค์ การอัปเดตที่จะทำให้เกินขีดจำกัดนี้จะดำเนินการไม่สำเร็จทันที และจะตั้งค่า runtime.lastError เมื่อใช้ Callback หรือเมื่อมีการปฏิเสธ Promise
MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE

1000000

เลิกใช้งาน

Storage.sync API ไม่มีโควต้าการดำเนินการเขียนที่ยั่งยืนอีกต่อไป
MAX_WRITE_OPERATIONS_PER_HOUR

1800

จำนวนการดำเนินการ set, remove หรือ clear สูงสุดที่ดำเนินการได้ในแต่ละชั่วโมง ซึ่งก็คือ 1 รายการทุก 2 วินาที ซึ่งเป็นขีดจำกัดที่ต่ำกว่าขีดจำกัดการเขียนต่อนาทีที่สูงขึ้นในระยะสั้น

การอัปเดตที่จะทำให้เกินขีดจำกัดนี้จะดำเนินการไม่สำเร็จทันทีและตั้งค่า runtime.lastError เมื่อใช้การเรียกกลับ หรือเมื่อ Promise ถูกปฏิเสธ
MAX_WRITE_OPERATIONS_PER_MINUTE

120

จำนวนการดำเนินการ set, remove หรือ clear สูงสุดที่ทำได้ในแต่ละนาที ซึ่งเท่ากับ 2 ต่อวินาที จึงให้อัตราการส่งข้อมูลสูงกว่าการเขียนต่อชั่วโมงในระยะเวลาที่สั้นลง

การอัปเดตที่จะทำให้เกินขีดจำกัดนี้จะดำเนินการไม่สำเร็จทันที และจะตั้งค่า runtime.lastError เมื่อใช้ Callback หรือเมื่อมีการปฏิเสธ Promise
QUOTA_BYTES

102400

จำนวนข้อมูลทั้งหมดสูงสุด (เป็นไบต์) ที่เก็บไว้ในพื้นที่เก็บข้อมูลการซิงค์ได้ ซึ่งวัดจากการแปลงค่าทั้งหมดเป็นสตริง JSON บวกกับความยาวของคีย์แต่ละรายการ การอัปเดตที่จะทำให้เกินขีดจำกัดนี้จะดำเนินการไม่สำเร็จทันทีและตั้งค่า runtime.lastError เมื่อใช้การเรียกกลับ หรือเมื่อ Promise ถูกปฏิเสธ
QUOTA_BYTES_PER_ITEM

8192

ขนาดสูงสุด (เป็นไบต์) ของแต่ละรายการในพื้นที่เก็บข้อมูลที่ซิงค์ ซึ่งวัดโดยการจัดเรียงสตริง JSON ของค่าและความยาวของคีย์ การอัปเดตที่มีรายการที่มีขนาดใหญ่กว่าขีดจำกัดนี้จะดำเนินการไม่สำเร็จทันทีและจะตั้งค่า runtime.lastError เมื่อใช้ Callback หรือเมื่อมีการปฏิเสธ Promise

กิจกรรม

onChanged

chrome.storage.onChanged.addListener(
  callback: function,
)

เริ่มทำงานเมื่อมีการเปลี่ยนแปลงอย่างน้อย 1 รายการ

พารามิเตอร์

Callback

ฟังก์ชัน

พารามิเตอร์ callback มีลักษณะดังนี้
```
(changes: object, areaName: string) => void
```
- การเปลี่ยนแปลง
  
  ออบเจ็กต์
- areaName
  
  สตริง