CKTIS / JavaScript
Storage.clear() — odstranitev vseh vnosov
Storage.clear() sinhrono odstrani vse pare ključ–vrednost iz izbranega območja Web Storage. Ne sprejme argumentov in vrne undefined. Pozor: izbriše tudi vnose, ki niso povezani z vašo kodo.
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.clear()Storage.clear deluje na objektu Storage: localStorage.clear() izprazni lokalno območje zadevnega izvora, sessionStorage.clear() pa izprazni sejno območje tega izvora in zavihka. Ne izprazni obeh hkrati. To je API standarda HTML, ne ECMAScript.
Metoda je sinhrona, ne sprejme argumentov in vrne undefined. Prazno območje ostane prazno. Za odstranitev posameznega vnosa uporabite removeItem(key); clear() ključev ne filtrira po predponi.
Odstranitev vnosov uvrsti dogodek storage v čakalno vrsto za druge upravičene dokumente, ki si delijo območje, ne pa za dokument, ki je metodo poklical. Polja key, oldValue in newValue imajo vrednost null. Prazno območje ne sproži dogodka.
Dostop do window.localStorage ali window.sessionStorage lahko sproži SecurityError, na primer zaradi pravil brskalnika. V primeru ima iframe zaradi izolacije z atributom sandbox neprosojen izvor. Izraz typeof Storage.prototype.clear vrne "function", vendar branje window.sessionStorage sproži SecurityError, še preden koda pokliče clear(). Noben vnos se ne izbriše. Uspešen klic sessionStorage.clear() preizkusite le v ločenem testnem zavihku in na testnem izvoru: klic izbriše vse vnose v sejni shrambi, tudi tiste, ki so že bili v njej.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.clear() and storage access</title>
</head>
<body>
<script>
const frame = document.createElement('iframe');
frame.title = 'Isolated Storage.clear test';
frame.setAttribute('sandbox', 'allow-scripts');
frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Storage clear test</title></head>
<body>
<p role="status"></p>
<script>
const methodType = typeof Storage.prototype.clear;
const methodStatus = 'typeof Storage.prototype.clear: ' + methodType;
let resultStatus;
try {
const storage = window.sessionStorage;
storage.setItem('demo:color', 'blue');
storage.setItem('demo:count', '2');
const result = storage.clear();
resultStatus = 'Remaining entries: ' + storage.length + '; return value: ' + String(result);
} catch (error) {
resultStatus = 'Clear not completed: ' + error.name;
}
document.querySelector('[role="status"]').textContent = methodStatus + '. ' + resultStatus;
console.log(methodStatus);
console.log(resultStatus);
<\/script>
</body>
</html>`;
document.body.append(frame);
</script>
</body>
</html>Rezultat
typeof Storage.prototype.clear: function Clear not completed: SecurityError
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.