Коротка відповідь
Не зберігайте чутливе без потреби. Storage залежить від строку й reader: local і sync постійні, session у пам’яті очищується на межах browser чи extension lifecycle. Це не універсальні шифровані сейфи. Обирайте короткі credentials та provider-handling, де API підтримує.
Локальна обробка теж приватна. Snippet, query URL, файл чи історія можуть містити більше, ніж видно. Розділіть preferences, credentials і дані сторінки для мінімального content-script доступу.
Практичні кроки реалізації
Класифікуйте дані й строк
Запишіть поля, purpose, writer, reader, строк і deletion. Theme є preference; не зберігайте HTML заради стилю. Палітри Native Color Picker — малий dataset, а токени й приватний текст потребують іншого огляду. Local не означає нешкідливе.
Обмежте менш довірених reader
Local і sync типово відкриті content scripts; setAccessLevel обмежує trusted contexts. Session типово не відкритий. Theme чи flag передавайте вузьким валідним повідомленням, не всім sensitive-storage.
Реалізуйте expiry й deletion
Задайте expiry й перевіряйте при читанні. Session переживає worker-suspension, але токен не вічний. Очищуйте account-values при logout чи зміні; не логуйте. Deletion має відповідати areas і записам, а export є окремою копією.
Уникайте декоративного шифрування
Ключ поруч із ciphertext не захищає від читача обох. Ключ пакета не секрет. Визначте attacker і шлях захисту та справжній key-management. Часто менше зберігання є простішим дієвим контролем.
Приклад реалізації
Ініціалізація обмежує local trusted-контекстами й кладе обмежене виділення в session із коротким expiry. Потрібен storage. Строк умовний.
await chrome.storage.local.setAccessLevel({ accessLevel: "TRUSTED_CONTEXTS" });
await chrome.storage.session.set({
pendingSelection: { text: selection.slice(0, 500), expiresAt: Date.now() + 60_000 },
});
const { pendingSelection } = await chrome.storage.session.get("pendingSelection");
if (!pendingSelection || typeof pendingSelection.expiresAt !== "number" ||
pendingSelection.expiresAt <= Date.now()) {
await chrome.storage.session.remove("pendingSelection");
}
Selection має бути валідним рядком. Реальний reader перевіряє повну схему й потрібного caller. Access levels ініціалізуйте до handlers даних.
Компроміси та альтернативи
Persistent підтримує restart із retention. Session підходить тимчасовому й worker-restart, не browser-restart. Sync додає пристрої й quotas; не називайте local-only. Вибирайте за recovery і privacy.
Поширені помилки
- Credentials у sync-preference.
- Усе storage скриптам.
- Вічний page-content.
- Embedded-key як секрет.
- UI-clear без deletion.
Контрольний список перед випуском
- Поля мають purpose й строк.
- Sensitive і preferences окремі.
- Access levels узгоджені.
- Expiry й account очищуються.
- Logs без приватного.
- Local, sync і exports описано.
Поширені запитання
Чи storage.session постійне?
Ні. Воно в пам’яті й очищується lifecycle. Durable-recovery плануйте окремо.
Чи local унеможливлює помилки?
Ні. Retention, messages, logs і exports можуть розкрити. Locality — одна властивість.
Висновок
Спершу мінімізуйте, потім reader, expiry й deletion. Storage керує lifecycle, не замінює валідацію чи захист credentials.
Первинні джерела
Пов’язані посібники та приклади
Потрібно реалізувати це у вашому продукті?
Інструменти браузера з чіткою метою, обґрунтованими дозволами та підтримуваною архітектурою Manifest V3.