---
title: Window.localStorage
slug: Web/API/Window/localStorage
translation_of: Web/API/Window/localStorage
---
<p>{{APIRef("Web Storage API")}}</p>

<p>התכונה לקריאה בלבד <span class="seoSummary"> <strong><code>localStorage</code></strong>  מאפשרת לך לגשת לאובייקט מסוג {{DOMxRef("Storage")}} עבור המקור של   {{DOMxRef("Document")}}; הנתונים המאוחסנים</span><span class="seoSummary">נשמרים בכל מפגשי הדפדפן.</span> <code>localStorage</code>   דומה ל-{{DOMxRef("Window.sessionStorage", "sessionStorage")}}, פרט לכך שבעוד תוקפם של הנתונים הנשמרים ב- <code>localStorage</code> אינו פג, נתונים הנשמרים ב-,<code>sessionStorage</code> נמחקים עם תום המפגש של הדף  —  כלומר, כשהדף נסגר.</p>

<p>יש לציין כי נתונים הנשמרים  ב-<code>localStorage</code> או ב-<code>sessionStorage</code>  הם מפורטים בפרוטוקול הדף.</p>

<p>המפתחות והערכים יביו <strong>תמיד מחרוזות</strong> (לתשומת לבך, בדומה לאובייקטים, מפתחות מטיפוס מספר שלם יומרו אוטומטית למחרוזות).</p>

<h2 id="תחביר">תחביר</h2>

<pre class="syntaxbox"><em>myStorage</em> = <em>window</em>.localStorage;</pre>

<h3 id="ערך">ערך</h3>

<p>אובייקט מסוג {{DOMxRef("Storage")}} שניתן להשתמש בו לגישה לשטח האיחסון המקומי של המקור הנוכחי.</p>

<h3 id="חריגות">חריגות</h3>

<dl>
 <dt><code>SecurityError</code></dt>
 <dd>הבקשה מפרה החלטות מדיניות, או שהמקור אינו  <a href="/en-US/docs/Web/Security/Same-origin_policy#Definition_of_an_origin">a valid scheme/host/port tuple</a> (זה יכול לקרות אם המקור משתמש בסכמת (t <code>file:</code> או <code>data:</code>, למשל). לדוגמא, ייתכן שלמשתמש דפדפן המוגדר כך שישלול הרשאה לשמור נתונים כבלתי משתנים עבור מקור מסויים.</dd>
</dl>

<h2 id="דוגמא">דוגמא</h2>

<p>קטע הקוד הבא ניגש לאובייקט ה-{{DOMxRef("Storage")}} המקומי של המתחם הנוכחי , ומוסיף לו נתון באמצעות {{DOMxRef("Storage.setItem()")}}.</p>

<pre class="brush: js">localStorage.setItem('myCat', 'Tom');</pre>

<p>התחביר לקריאת נתון ה-<code>localStorage</code> הוא כדלקמן:</p>

<pre class="brush: js">var cat = localStorage.getItem('myCat');</pre>

<p> התחביר למחיקת נתון ה-<code>localStorage</code> הוא כדלקמן:</p>

<pre class="brush: js">localStorage.removeItem('myCat');</pre>

<p>התחביר למחיקת כל הנתונים ב-<code>localStorage</code>  הוא כדלקמן:</p>

<pre class="brush: js">// Clear all items
localStorage.clear();
</pre>

<div class="note">
<p><strong>לתשומת לבך</strong>: נא לעיין במאמר  <a href="/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API">Using the Web Storage API</a>   כדי לצפות בדוגמא השלמה.</p>
</div>

<h2 id="מפרטים">מפרטים</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">מפרט</th>
   <th scope="col">מצב</th>
   <th scope="col">הערה</th>
  </tr>
  <tr>
   <td>{{SpecName("HTML WHATWG", "webstorage.html#dom-localstorage", "localStorage")}}</td>
   <td>{{Spec2("HTML WHATWG")}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="תאימות_דפדפנים">תאימות דפדפנים</h2>

<div class="hidden">טבלת התאימות בדף זה נוצרה מנתונים המסודרים במבנה. אם תרצו לתרום לנתונים, אנא שלפו מ- <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>  pull request ושלחו לנו בקשת משיכה.</div>

<p>{{Compat("api.Window.localStorage")}}</p>

<h2 id="לעיון_נוסף">לעיון נוסף</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API">Using the Web Storage API</a></li>
 <li><a href="/en-US/docs/Web/API/Web_Storage_API/Local_storage">Local storage with Window.localStorage</a></li>
 <li><span style="font-size: 1rem; letter-spacing: -0.00278rem;">{{DOMxRef("Window.sessionStorage")}}</span></li>
</ul>