CKTIS / JavaScript
Storage.clear() — uklanjanje svih stavki
Storage.clear() sinkrono uklanja sve parove ključ–vrijednost iz odabranog područja Web Storagea. Ne prima argumente i vraća undefined. Oprez: briše i stavke koje nisu povezane s vašim kodom.
Verzija: 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 radi na objektu Storage: localStorage.clear() prazni lokalno područje odgovarajućeg origina, dok sessionStorage.clear() prazni sesijsko područje tog origina i kartice. Ne prazni oba istodobno. To je API standarda HTML, a ne ECMAScripta.
Metoda je sinkrona, ne prima argumente i vraća undefined. Prazno područje ostaje prazno. Za uklanjanje jedne stavke upotrijebite removeItem(key); clear() ne filtrira ključeve prema prefiksu.
Uklanjanje stavki stavlja događaj storage u red čekanja za druge ovlaštene dokumente koji dijele područje, ali ne i za dokument koji je pozvao metodu. Polja key, oldValue i newValue tada imaju vrijednost null. Prazno područje ne uzrokuje događaj.
Pristup objektu window.localStorage ili window.sessionStorage može izazvati SecurityError, primjerice zbog pravila preglednika. U primjeru iframe zbog izolacije atributom sandbox ima neproziran origin. Izraz typeof Storage.prototype.clear vraća "function", ali čitanje window.sessionStorage izaziva SecurityError prije nego što kôd pozove clear(). Nijedna se stavka ne briše. Uspješan poziv sessionStorage.clear() isprobajte samo na zasebnoj testnoj kartici i na testnom originu: taj poziv briše sve stavke iz sesijske pohrane, uključujući one koje su već bile u njoj.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.