it-roy-ru.com

Хранение объектов в HTML5 localStorage

Я хотел бы сохранить объект JavaScript в HTML5 localStorage, но мой объект, очевидно, преобразуется в строку.

Я могу хранить и извлекать примитивные типы и массивы JavaScript, используя localStorage, но объекты, похоже, не работают. Должны ли они?

Вот мой код:

var testObject = { 'one': 1, 'two': 2, 'three': 3 };
console.log('typeof testObject: ' + typeof testObject);
console.log('testObject properties:');
for (var prop in testObject) {
    console.log('  ' + prop + ': ' + testObject[prop]);
}

// Put the object into storage
localStorage.setItem('testObject', testObject);

// Retrieve the object from storage
var retrievedObject = localStorage.getItem('testObject');

console.log('typeof retrievedObject: ' + typeof retrievedObject);
console.log('Value of retrievedObject: ' + retrievedObject);

Консольный вывод

typeof testObject: object
testObject properties:
  one: 1
  two: 2
  three: 3
typeof retrievedObject: string
Value of retrievedObject: [object Object]

Мне кажется, что метод setItem преобразует входные данные в строку перед ее сохранением.

Я вижу такое поведение в Safari, Chrome и Firefox, поэтому я предполагаю, что это мое неправильное понимание спецификации HTML5 Web Storage , а не ошибка или ограничение для конкретного браузера.

Я попытался разобраться в алгоритме структурированного клона , описанном в http://www.w3.org/TR/html5/ infrastructure.html . Я не до конца понимаю, что он говорит, но, возможно, моя проблема связана с тем, что свойства моего объекта не перечисляются (???)

Есть ли легкий обходной путь?


Обновление: W3C в конечном итоге изменил свое мнение о спецификации структурированных клонов и решил изменить спецификацию в соответствии с реализациями. Смотрите https://www.w3.org/Bugs/Public/show_bug.cgi?id=12111 . Таким образом, этот вопрос больше не является действительным на 100%, но ответы все еще могут представлять интерес.

2290
Kristopher Johnson

Глядя на документацию Apple , Mozilla и снова Mozilla , кажется, что функциональность ограничена, чтобы обрабатывать только пары ключ/значение строки.

Обходным путем может быть stringify ваш объект перед его сохранением и последующим анализом при получении:

var testObject = { 'one': 1, 'two': 2, 'three': 3 };

// Put the object into storage
localStorage.setItem('testObject', JSON.stringify(testObject));

// Retrieve the object from storage
var retrievedObject = localStorage.getItem('testObject');

console.log('retrievedObject: ', JSON.parse(retrievedObject));
2905
CMS

Незначительное улучшение вариант :

Storage.prototype.setObject = function(key, value) {
    this.setItem(key, JSON.stringify(value));
}

Storage.prototype.getObject = function(key) {
    var value = this.getItem(key);
    return value && JSON.parse(value);
}

Из-за оценка короткого замыкания , getObject() немедленно вернет null, если key отсутствует в хранилище. Он также не будет генерировать исключение SyntaxError, если value равно "" (пустая строка; JSON.parse() не может обработать это).

594
Guria

Возможно, вам будет полезно расширить объект Storage с помощью этих удобных методов:

Storage.prototype.setObject = function(key, value) {
    this.setItem(key, JSON.stringify(value));
}

Storage.prototype.getObject = function(key) {
    return JSON.parse(this.getItem(key));
}

Таким образом, вы получаете функциональность, которая вам действительно нужна, хотя под API поддерживаются только строки.

206
Justin Voskuhl

Расширение объекта Storage - это отличное решение. Для своего API я создал фасад для localStorage и затем проверяю, является ли он объектом или нет, при установке и получении.

var data = {
  set: function(key, value) {
    if (!key || !value) {return;}

    if (typeof value === "object") {
      value = JSON.stringify(value);
    }
    localStorage.setItem(key, value);
  },
  get: function(key) {
    var value = localStorage.getItem(key);

    if (!value) {return;}

    // assume it is an object that has been stringified
    if (value[0] === "{") {
      value = JSON.parse(value);
    }

    return value;
  }
}
68
Alex Grande

Stringify не решает всех проблем

Кажется, что ответы здесь не охватывают все типы, которые возможны в JavaScript, поэтому вот несколько коротких примеров того, как правильно обращаться с ними:

//Objects and Arrays:
    var obj = {key: "value"};
    localStorage.object = JSON.stringify(obj);  //Will ignore private members
    obj = JSON.parse(localStorage.object);
//Boolean:
    var bool = false;
    localStorage.bool = bool;
    bool = (localStorage.bool === "true");
//Numbers:
    var num = 42;
    localStorage.num = num;
    num = +localStorage.num;    //short for "num = parseFloat(localStorage.num);"
//Dates:
    var date = Date.now();
    localStorage.date = date;
    date = new Date(parseInt(localStorage.date));
//Regular expressions:
    var regex = /^No\.[\d]*$/i;     //usage example: "No.42".match(regex);
    localStorage.regex = regex;
    var components = localStorage.regex.match("^/(.*)/([a-z]*)$");
    regex = new RegExp(components[1], components[2]);
//Functions (not recommended):
    function func(){}
    localStorage.func = func;
    eval( localStorage.func );      //recreates the function with the name "func"

Я не рекомендую хранить функции, потому что eval() это зло, может привести к проблемам, связанным с безопасностью, оптимизацией и отладкой. В общем, eval() никогда не должен использоваться в коде JavaScript.

Частные участники

Проблема с использованием JSON.stringify() для хранения объектов заключается в том, что эта функция не может сериализовать закрытые члены. Эту проблему можно решить, переписав метод .toString() (который неявно вызывается при хранении данных в веб-хранилище):

//Object with private and public members:
    function MyClass(privateContent, publicContent){
        var privateMember = privateContent || "defaultPrivateValue";
        this.publicMember = publicContent  || "defaultPublicValue";

        this.toString = function(){
            return '{"private": "' + privateMember + '", "public": "' + this.publicMember + '"}';
        };
    }
    MyClass.fromString = function(serialisedString){
        var properties = JSON.parse(serialisedString || "{}");
        return new MyClass( properties.private, properties.public );
    };
//Storing:
    var obj = new MyClass("invisible", "visible");
    localStorage.object = obj;
//Loading:
    obj = MyClass.fromString(localStorage.object);

Циркулярные ссылки

Другой проблемой, с которой stringify не может справиться, являются циклические ссылки:

var obj = {};
obj["circular"] = obj;
localStorage.object = JSON.stringify(obj);  //Fails

В этом примере JSON.stringify() выдаст TypeError "Преобразование круговой структуры в JSON" . Если должно поддерживаться хранение циклических ссылок, можно использовать второй параметр JSON.stringify():

var obj = {id: 1, sub: {}};
obj.sub["circular"] = obj;
localStorage.object = JSON.stringify( obj, function( key, value) {
    if( key == 'circular') {
        return "$ref"+value.id+"$";
    } else {
        return value;
    }
});

Однако поиск эффективного решения для хранения циклических ссылок в значительной степени зависит от задач, которые необходимо решить, и восстановление таких данных также не является тривиальным.

В SO уже есть вопрос, касающийся этой проблемы: Stringify (преобразовать в JSON) объект JavaScript с циклической ссылкой

59
maja

Есть отличная библиотека, которая оборачивает многие решения, поэтому она даже поддерживает старые браузеры, называемые jStorage

Вы можете установить объект

$.jStorage.set(key, value)

И получить это легко

value = $.jStorage.get(key)
value = $.jStorage.get(key, "default value")
52
JProgrammer

Использование объектов JSON для локального хранения:

//ЗАДАВАТЬ

var m={name:'Hero',Title:'developer'};
localStorage.setItem('us', JSON.stringify(m));

//ПОЛУЧИТЬ

var gm =JSON.parse(localStorage.getItem('us'));
console.log(gm.name);

// Итерация всех ключей и значений локального хранилища

for (var i = 0, len = localStorage.length; i < len; ++i) {
  console.log(localStorage.getItem(localStorage.key(i)));
}

// УДАЛЯТЬ

localStorage.removeItem('us');
delete window.localStorage["us"];
33
Shujaath Khan

Теоретически возможно хранить объекты с функциями:

function store (a)
{
  var c = {f: {}, d: {}};
  for (var k in a)
  {
    if (a.hasOwnProperty(k) && typeof a[k] === 'function')
    {
      c.f[k] = encodeURIComponent(a[k]);
    }
  }

  c.d = a;
  var data = JSON.stringify(c);
  window.localStorage.setItem('CODE', data);
}

function restore ()
{
  var data = window.localStorage.getItem('CODE');
  data = JSON.parse(data);
  var b = data.d;

  for (var k in data.f)
  {
    if (data.f.hasOwnProperty(k))
    {
      b[k] = eval("(" + decodeURIComponent(data.f[k]) + ")");
    }
  }

  return b;
}

Однако сериализация/десериализация функций ненадежна, потому что это зависит от реализации .

27
aster_x

Вы также можете переопределить стандартные методы Storage setItem(key,value) и getItem(key) для обработки объектов/массивов, как и любой другой тип данных. Таким образом, вы можете просто вызывать localStorage.setItem(key,value) и localStorage.getItem(key), как обычно.

Я не проверял это подробно, но, похоже, он работал без проблем для небольшого проекта, с которым я возился.

Storage.prototype._setItem = Storage.prototype.setItem;
Storage.prototype.setItem = function(key, value)
{
  this._setItem(key, JSON.stringify(value));
}

Storage.prototype._getItem = Storage.prototype.getItem;
Storage.prototype.getItem = function(key)
{  
  try
  {
    return JSON.parse(this._getItem(key));
  }
  catch(e)
  {
    return this._getItem(key);
  }
}
22
danott

Я пришел к этому сообщению после того, как нажал на другое сообщение, которое было закрыто как дубликат этого - под названием "Как сохранить массив в localalstorage?". Это нормально, за исключением того, что ни один из потоков на самом деле не дает полного ответа о том, как вы можете поддерживать массив в localStorage - однако мне удалось разработать решение на основе информации, содержащейся в обоих потоках.

Так что, если кто-то еще хочет иметь возможность помещать/выгружать/сдвигать элементы в массиве, и он хочет, чтобы этот массив хранился в localStorage или действительно sessionStorage, вот вам:

Storage.prototype.getArray = function(arrayName) {
  var thisArray = [];
  var fetchArrayObject = this.getItem(arrayName);
  if (typeof fetchArrayObject !== 'undefined') {
    if (fetchArrayObject !== null) { thisArray = JSON.parse(fetchArrayObject); }
  }
  return thisArray;
}

Storage.prototype.pushArrayItem = function(arrayName,arrayItem) {
  var existingArray = this.getArray(arrayName);
  existingArray.Push(arrayItem);
  this.setItem(arrayName,JSON.stringify(existingArray));
}

Storage.prototype.popArrayItem = function(arrayName) {
  var arrayItem = {};
  var existingArray = this.getArray(arrayName);
  if (existingArray.length > 0) {
    arrayItem = existingArray.pop();
    this.setItem(arrayName,JSON.stringify(existingArray));
  }
  return arrayItem;
}

Storage.prototype.shiftArrayItem = function(arrayName) {
  var arrayItem = {};
  var existingArray = this.getArray(arrayName);
  if (existingArray.length > 0) {
    arrayItem = existingArray.shift();
    this.setItem(arrayName,JSON.stringify(existingArray));
  }
  return arrayItem;
}

Storage.prototype.unshiftArrayItem = function(arrayName,arrayItem) {
  var existingArray = this.getArray(arrayName);
  existingArray.unshift(arrayItem);
  this.setItem(arrayName,JSON.stringify(existingArray));
}

Storage.prototype.deleteArray = function(arrayName) {
  this.removeItem(arrayName);
}

пример использования - хранение простых строк в массиве localStorage:

localStorage.pushArrayItem('myArray','item one');
localStorage.pushArrayItem('myArray','item two');

пример использования - хранение объектов в массиве sessionStorage:

var item1 = {}; item1.name = 'fred'; item1.age = 48;
sessionStorage.pushArrayItem('myArray',item1);

var item2 = {}; item2.name = 'dave'; item2.age = 22;
sessionStorage.pushArrayItem('myArray',item2);

распространенные методы манипулирования массивами:

.pushArrayItem(arrayName,arrayItem); -> adds an element onto end of named array
.unshiftArrayItem(arrayName,arrayItem); -> adds an element onto front of named array
.popArrayItem(arrayName); -> removes & returns last array element
.shiftArrayItem(arrayName); -> removes & returns first array element
.getArray(arrayName); -> returns entire array
.deleteArray(arrayName); -> removes entire array from storage
21
Andy Lorenz

Рекомендуем использовать библиотеку абстракций для многих функций, обсуждаемых здесь, а также для лучшей совместимости. Много вариантов:

13
doublejosh

Лучше делать функции как setter и getter для localStorage, таким образом, вы будете иметь лучший контроль и вам не придется повторять разбор JSON и все. он даже плавно обработает ваш ("") пустой ключ строки/регистр данных.

function setItemInStorage(dataKey, data){
    localStorage.setItem(dataKey, JSON.stringify(data));
}

function getItemFromStorage(dataKey){
    var data = localStorage.getItem(dataKey);
    return data? JSON.parse(data): null ;
}

setItemInStorage('user', { name:'tony stark' });
getItemFromStorage('user'); /* return {name:'tony stark'} */
10
sheelpriy

Я немного изменил один из самых популярных ответов. Я фанат одной функции вместо 2, если она не нужна.

Storage.prototype.object = function(key, val) {
    if ( typeof val === "undefined" ) {
        var value = this.getItem(key);
        return value ? JSON.parse(value) : null;
    } else {
        this.setItem(key, JSON.stringify(val));
    }
}

localStorage.object("test", {a : 1}); //set value
localStorage.object("test"); //get value

Кроме того, если значение не установлено, возвращается null вместо false. false имеет некоторое значение, null не имеет.

8
pie6k

Улучшение ответа @Guria:

Storage.prototype.setObject = function (key, value) {
    this.setItem(key, JSON.stringify(value));
};


Storage.prototype.getObject = function (key) {
    var value = this.getItem(key);
    try {
        return JSON.parse(value);
    }
    catch(err) {
        console.log("JSON parse failed for lookup of ", key, "\n error was: ", err);
        return null;
    }
};
6
seanp2k

Вы можете использовать localDataStorage для прозрачного хранения типов данных javascript (Array, Boolean, Date, Float, Integer, String и Object). Он также обеспечивает упрощенную обфускацию данных, автоматически сжимает строки, облегчает запрос по ключу (имени), а также по запросу (ключу) и помогает обеспечить сегментированное общее хранилище в том же домене с помощью префикса ключей.

[ОТКАЗ ОТ ОТВЕТСТВЕННОСТИ] Я являюсь автором утилиты [/ ОТКАЗ ОТ ОТВЕТСТВЕННОСТИ]

Примеры:

localDataStorage.set( 'key1', 'Belgian' )
localDataStorage.set( 'key2', 1200.0047 )
localDataStorage.set( 'key3', true )
localDataStorage.set( 'key4', { 'RSK' : [1,'3',5,'7',9] } )
localDataStorage.set( 'key5', null )

localDataStorage.get( 'key1' )   -->   'Belgian'
localDataStorage.get( 'key2' )   -->   1200.0047
localDataStorage.get( 'key3' )   -->   true
localDataStorage.get( 'key4' )   -->   Object {RSK: Array(5)}
localDataStorage.get( 'key5' )   -->   null

Как видите, примитивные значения соблюдаются.

5
Mac

Вы можете использовать ejson для хранения объектов в виде строк.

EJSON является расширением JSON для поддержки большего количества типов. Он поддерживает все JSON-безопасные типы, а также:

  • Дата (JavaScript Date)
  • Двоичный (JavaScript Uint8Array или результат EJSON.newBinary )
  • Пользовательские типы (см. EJSON.addType . Например, Mongo.ObjectID реализован таким образом.)

Все сериализации EJSON также действительны в формате JSON. Например, объект с датой и двоичным буфером будет сериализован в EJSON как:

{
  "d": {"$date": 1358205756553},
  "b": {"$binary": "c3VyZS4="}
}

Вот моя оболочка localStorage, использующая ejson

https://github.com/UziTech/storage.js

Я добавил несколько типов в свою оболочку, включая регулярные выражения и функции

4
Tony Brix

Другой вариант будет использовать существующий плагин.

Например, persisto - это проект с открытым исходным кодом, который предоставляет простой интерфейс для localStorage/sessionStorage и автоматизирует сохранение для полей формы (ввод, переключатели и флажки).

persisto features

(Отказ от ответственности: я автор.)

4
mar10

Я сделал еще одну минималистичную оболочку, содержащую всего 20 строк кода, чтобы использовать ее так, как следует:

localStorage.set('myKey',{a:[1,2,5], b: 'ok'});
localStorage.has('myKey');   // --> true
localStorage.get('myKey');   // --> {a:[1,2,5], b: 'ok'}
localStorage.keys();         // --> ['myKey']
localStorage.remove('myKey');

https://github.com/zevero/simpleWebstorage

3
zevero

http://rhaboo.org - это слой сахара localStorage, который позволяет писать такие вещи:

var store = Rhaboo.persistent('Some name');
store.write('count', store.count ? store.count+1 : 1);
store.write('somethingfancy', {
  one: ['man', 'went'],
  2: 'mow',
  went: [  2, { mow: ['a', 'meadow' ] }, {}  ]
});
store.somethingfancy.went[1].mow.write(1, 'lawn');

Он не использует JSON.stringify/parse, потому что это будет неточно и медленно для больших объектов. Вместо этого каждое значение терминала имеет свою собственную запись localStorage.

Вы можете догадаться, что я могу иметь какое-то отношение к rhaboo ;-)

Адриан.

3
Adrian May

Для пользователей TypeScript, желающих установить и получить типизированные свойства:

/**
 * Silly wrapper to be able to type the storage keys
 */
export class TypedStorage<T> {

    public removeItem(key: keyof T): void {
        localStorage.removeItem(key);
    }

    public getItem<K extends keyof T>(key: K): T[K] | null {
        const data: string | null =  localStorage.getItem(key);
        return JSON.parse(data);
    }

    public setItem<K extends keyof T>(key: K, value: T[K]): void {
        const data: string = JSON.stringify(value);
        localStorage.setItem(key, data);
    }
}

Пример использования :

// write an interface for the storage
interface MyStore {
   age: number,
   name: string,
   address: {city:string}
}

const storage: TypedStorage<MyStore> = new TypedStorage<MyStore>();

storage.setItem("wrong key", ""); // error unknown key
storage.setItem("age", "hello"); // error, age should be number
storage.setItem("address", {city:"Here"}); // ok

const address: {city:string} = storage.getItem("address");
2
Flavien Volken

Вот некоторая расширенная версия кода, размещенная @danott

Он также реализует значение delete из localstorage и показывает, как добавить слой Getter и Setter, чтобы вместо

localstorage.setItem(preview, true)

ты можешь написать

config.preview = true

Ладно, вот и пошли

var PT=Storage.prototype

if (typeof PT._setItem >='u') PT._setItem = PT.setItem;
PT.setItem = function(key, value)
{
  if (typeof value >='u')//..ndefined
    this.removeItem(key)
  else
    this._setItem(key, JSON.stringify(value));
}

if (typeof PT._getItem >='u') PT._getItem = PT.getItem;
PT.getItem = function(key)
{  
  var ItemData = this._getItem(key)
  try
  {
    return JSON.parse(ItemData);
  }
  catch(e)
  {
    return ItemData;
  }
}

// Aliases for localStorage.set/getItem 
get =   localStorage.getItem.bind(localStorage)
set =   localStorage.setItem.bind(localStorage)

// Create ConfigWrapperObject
var config = {}

// Helper to create getter & setter
function configCreate(PropToAdd){
    Object.defineProperty( config, PropToAdd, {
      get: function ()      { return (  get(PropToAdd)      ) },
      set: function (val)   {           set(PropToAdd,  val ) }
    })
}
//------------------------------

// Usage Part
// Create properties
configCreate('preview')
configCreate('notification')
//...

// Config Data transfer
//set
config.preview = true

//get
config.preview

// delete
config.preview = undefined

Ну, вы можете удалить псевдонимы с помощью .bind(...). Тем не менее, я просто вставил это, потому что об этом очень приятно знать. Я потратил несколько часов, чтобы выяснить, почему простой get = localStorage.getItem; не работает

1
Nadu

Смотри это

Допустим, у вас есть следующий массив с именем movies:

var movies = ["Reservoir Dogs", "Pulp Fiction", "Jackie Brown", 
              "Kill Bill", "Death Proof", "Inglourious Basterds"];

Используя функцию stringify, ваш массив movies можно превратить в строку, используя следующий синтаксис:

localStorage.setItem("quentinTarantino", JSON.stringify(movies));

Обратите внимание, что мои данные хранятся под ключом, называемым quentinTarantino.

Получение ваших данных

var retrievedData = localStorage.getItem("quentinTarantino");

Чтобы преобразовать строку обратно в объект, используйте функцию анализа JSON:

var movies2 = JSON.parse(retrievedData);

Вы можете вызывать все методы массива на вашем movie2

1
shas

Чтобы сохранить объект, вы можете сделать буквы, которые вы можете использовать, чтобы получить объект из строки в объект (может не иметь смысла). Например

var obj = {a: "lol", b: "A", c: "hello world"};
function saveObj (key){
    var j = "";
    for(var i in obj){
        j += (i+"|"+obj[i]+"~");
    }
    localStorage.setItem(key, j);
} // Saving Method
function getObj (key){
    var j = {};
    var k = localStorage.getItem(key).split("~");
    for(var l in k){
        var m = k[l].split("|");
        j[m[0]] = m[1];
    }
    return j;
}
saveObj("obj"); // undefined
getObj("obj"); // {a: "lol", b: "A", c: "hello world"}

Эта техника вызовет некоторые сбои, если вы используете букву, которую вы использовали для разделения объекта, и она также очень экспериментальная.

1
Seizefire

Небольшой пример библиотеки, которая использует localStorage для отслеживания полученных сообщений от контактов:

// This class is supposed to be used to keep a track of received message per contacts.
// You have only four methods:

// 1 - Tells you if you can use this library or not...
function isLocalStorageSupported(){
    if(typeof(Storage) !== "undefined" && window['localStorage'] != null ) {
         return true;
     } else {
         return false;
     }
 }

// 2 - Give the list of contacts, a contact is created when you store the first message
 function getContacts(){
    var result = new Array();
    for ( var i = 0, len = localStorage.length; i < len; ++i ) {
        result.Push(localStorage.key(i));
    }
    return result;
 }

 // 3 - store a message for a contact
 function storeMessage(contact, message){
    var allMessages;
    var currentMessages = localStorage.getItem(contact);
    if(currentMessages == null){
        var newList = new Array();
        newList.Push(message);
        currentMessages = JSON.stringify(newList);
    }
    else
    {
        var currentList =JSON.parse(currentMessages);
        currentList.Push(message);
        currentMessages = JSON.stringify(currentList);
    }
    localStorage.setItem(contact, currentMessages);
 }

 // 4 - read the messages of a contact
 function readMessages(contact){

    var result = new Array();
    var currentMessages = localStorage.getItem(contact);

    if(currentMessages != null){
        result =JSON.parse(currentMessages);
    }
    return result;
 }
1
Thomas

Я сделал вещь, которая не ломает существующие объекты хранения, но создает оболочку, чтобы вы могли делать то, что вы хотите. В результате получается обычный объект, без методов, с доступом, как у любого объекта.

То, что я сделал.

Если вы хотите, чтобы 1 localStorage свойство было волшебным:

var prop = ObjectStorage(localStorage, 'prop');

Если вам нужно несколько:

var storage = ObjectStorage(localStorage, ['prop', 'more', 'props']);

Все, что вы делаете с prop или объектами внутри storage, будет автоматически сохранено в localStorage. Вы всегда играете с реальным объектом, поэтому вы можете делать такие вещи:

storage.data.list.Push('more data');
storage.another.list.splice(1, 2, {another: 'object'});

И каждый новый объект внутри отслеживаемого объекта будет автоматически отслеживаться.

Очень большой недостаток: это зависит от Object.observe(), поэтому он имеет очень ограниченную поддержку браузера. И не похоже, что это будет в ближайшее время для Firefox или Edge.

1
Rudie