---
title: Storage.setItem()
slug: Web/API/Storage/setItem
translation_of: Web/API/Storage/setItem
---
<p>{{APIRef("Web Storage API")}}<br>
 פונקציית <strong><code>()setItem</code></strong> מאפשרת להוסיף נתונים אל האחסון המקומי באמצעות שני פרמטרים: שם מפתח וערך שאותם תיצור או תעדכן במידה וקיימים.</p>

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

<pre class="syntaxbox"><em>storage</em>.setItem(<em>keyName</em>, <em>keyValue</em>);</pre>

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

<dl>
 <dt><code>keyName</code></dt>
 <dd>מכיל את שמו של המפתח אותו יש ליצור או לעדכן.</dd>
 <dt><code>keyValue</code></dt>
 <dd>מכיל את שם הערך שיתווסף למפתח אותו אנו יוצרים או מעדכנים.</dd>
</dl>

<h3 id="ערך_חוזר">ערך חוזר</h3>

<p><code>undefined</code>.</p>

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

<p>במידה והאחסון מלא המערכות עשויה לנקות נתונים מהאחסון המקומי.<br>
 בגרסה הניידת של דפדפן Safari, במידה והמשתמש נכנס אל מצב פרטי המערכת אינה שומרת נתונים באחסון המקומי ומסירה אותם באופן אוטומטי בשל מגבלת גודל של 0 בתים.</p>

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

<p>הפונקציה הבאה יוצרת שלושה פריטי נתונים בתוך האחסון המקומי.</p>

<pre class="brush: js">function populateStorage() {
  localStorage.setItem('bgcolor', 'red');
  localStorage.setItem('font', 'Helvetica');
  localStorage.setItem('image', 'myCat.png');
}</pre>

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

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-setitem', 'Storage.setItem')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

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



<p>{{Compat("api.Storage.setItem")}}</p>

<h2 id="ראו_גם">ראו גם</h2>

<ul>
 <li><a href="/he/docs/Web/API/Storage/getItem">()Storage.getItem</a></li>
 <li><a href="/he/docs/Web/API/Storage/removeItem">()Storage.removeItem</a></li>
</ul>