CKTIS / JavaScript
Storage.removeItem — odstranitev enega vnosa
Metoda removeItem(key) odstrani določen par ključ-vrednost iz localStorage ali sessionStorage. Vrne undefined; manjkajoči ključ ne povzroči napake.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
storage.removeItem(key)Storage.removeItem je sinhrona metoda Web Storage, določena v HTML Standard, ne pa v ECMAScriptu. Pokličite jo na localStorage ali sessionStorage in ključ podajte kot niz. Podpirajo jo vsa glavna brskalniška jedra, vendar vsa jedra ne podpirajo Web Storage. Prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.
removeItem(key) odstrani samo navedeni vnos in vrne undefined, tudi če ključ ne obstaja. Po odstranitvi getItem(key) vrne null. Nasprotno pa clear() odstrani vse vnose iz izbranega območja shrambe.
Ob dejanski odstranitvi se dogodek storage uvrsti v čakalno vrsto za druge dokumente, ki si delijo območje shrambe, ne pa za okno, ki izvaja operacijo; newValue je null. Če ključa ni, se dogodek ne sproži.
Dostop do window.localStorage ali window.sessionStorage lahko sproži izjemo SecurityError, na primer zaradi pravil brskalnika. Primer najprej poskusi uporabiti window.sessionStorage. Če se pri tem sproži izjema SecurityError ali QuotaExceededError, namesto Web Storage uporabi preizkusni objekt, ki podatke hrani v pomnilniku z uporabo Map. V obeh primerih izbere še neuporabljen ključ, pod njim shrani začasni vnos in ga nato odstrani.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.removeItem: removing one entry</title>
</head>
<body>
<h1>Removing a storage entry</h1>
<p id="source"></p>
<script>
function checkRemoval(storage) {
let key = 'cktis:removeItem';
while (storage.getItem(key) !== null) key += ':';
try {
storage.setItem(key, 'draft');
const removed = storage.removeItem(key);
const missing = storage.getItem(key) === null;
const removedAgain = storage.removeItem(key);
return [removed === undefined, missing, removedAgain === undefined && storage.getItem(key) === null];
} finally {
storage.removeItem(key);
}
}
let lines;
let source = 'Using browser sessionStorage.';
try {
lines = checkRemoval(window.sessionStorage);
} catch (error) {
if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
source = 'Could not access browser sessionStorage or write the test entry. Using an in-memory fixture, not Web Storage.';
const entries = new Map();
lines = checkRemoval({
getItem(key) { return entries.has(key) ? entries.get(key) : null; },
setItem(key, value) { entries.set(key, String(value)); },
removeItem(key) { entries.delete(key); }
});
}
document.getElementById('source').textContent = source;
for (const line of lines) console.log(line);
</script>
</body>
</html>Rezultat
true true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.