Chyba NS_ERROR_DOM_QUOTA_EXCEEDED_ERR se vyskytuje při práci s webovými technologiemi, konkrétně při ukládání dat do Local Storage nebo Session Storage v prohlížeči. Tato chyba signalizuje, že bylo dosaženo maximálního povoleného limitu pro uložení dat. Chyba je často spojována s moderními webovými aplikacemi, které intenzivně pracují s klientským úložištěm.

Co způsobuje chybu NS_ERROR_DOM_QUOTA_EXCEEDED_ERR?

K této chybě může dojít z několika důvodů:

1. Překročení limitu pro Local Storage: Každý prohlížeč má pro každou doménu stanovený maximální limit pro objem dat, která mohou být uložena v Local Storage nebo Session Storage. Tento limit se liší podle prohlížeče, obvykle se pohybuje kolem 5–10 MB. Když webová aplikace tento limit překročí, objeví se tato chyba.

2. Privátní režim prohlížeče: V privátním (inkognito) režimu mají některé prohlížeče, jako je Safari, velmi omezené nebo zcela zakázané úložiště pro Local Storage a Session Storage. V tomto případě je kvóta na úložiště extrémně nízká, což často vede k vyvolání této chyby.

3. Příliš mnoho datových položek: I když nemáte přímé překročení celkového objemu dat, může tato chyba nastat, pokud máte uloženo příliš mnoho jednotlivých položek, například mnoho různých klíčů v Local Storage.

4. Ukládání příliš velkých objektů: Pokud se pokusíte uložit velké objekty (například serializovaná data z velkého JSON souboru), může dojít k rychlému naplnění limitu pro Local Storage.

Jak opravit chybu NS_ERROR_DOM_QUOTA_EXCEEDED_ERR?

Existuje několik přístupů, jak tento problém vyřešit, a výběr závisí na konkrétní situaci.

1. Zkontrolujte a optimalizujte uložená data Analyzujte, kolik dat vaše aplikace ukládá do Local Storage. Pokud ukládáte zbytečně velké objemy dat, zvažte jejich optimalizaci. Můžete například:

• Ukládat menší fragmenty dat.
• Odstranit nepotřebná data.
• Komprimovat uložené objekty před jejich uložením (použít například JSON.stringify a následně Base64 pro ukládání menších dat).

2. Použití jiných metod ukládání dat Místo Local Storage lze použít i jiné metody ukládání dat, které mají větší kapacitu:

• IndexedDB – Tento moderní úložný systém má mnohem větší kapacitu než Local Storage a nabízí možnost pracovat s velkými datovými objekty.
• Cookies – I když mají cookies omezenou kapacitu (obvykle kolem 4KB), mohou být použity pro uložení menších dat.
• Server-side storage – Pokud neexistuje nutnost ukládat data na straně klienta, je lepší ukládat data na serveru a načítat je při potřebě.

3. Detekce dostupného úložiště před ukládáním dat Abyste zabránili chybě NS_ERROR_DOM_QUOTA_EXCEEDED_ERR, můžete implementovat kontrolu dostupné kvóty v Local Storage před tím, než začnete ukládat data. To lze provést následujícím způsobem:

function isLocalStorageAvailable() {
    try {
        const testKey = '__test__';
        localStorage.setItem(testKey, 'test');
        localStorage.removeItem(testKey);
        return true;
    } catch (e) {
        return e instanceof DOMException && (
            e.code === 22 ||
            e.code === 1014 || // Firefox
            e.name === 'QuotaExceededError' || // Chrome, Opera
            e.name === 'NS_ERROR_DOM_QUOTA_EXCEEDED_ERR'); // Firefox
    }
}

Tento kód detekuje, zda je Local Storage plně dostupné nebo zda by došlo k překročení kvóty při dalším uložení dat.

4. Ošetření chyby ve vašem kódu Pokud k chybě přece jen dojde, je důležité ji správně ošetřit, aby aplikace nezkolabovala. Můžete například chybu zachytit pomocí bloku try-catch:

try {
    localStorage.setItem('key', 'value');
} catch (e) {
    if (e.name === 'QuotaExceededError') {
        console.error('Local Storage je plné. Prosím, uvolněte místo.');
        // Implementace alternativního řešení
    }
}

5. Upozornění uživatele Pokud dojde k chybě, můžete uživatele informovat o tom, že místní úložiště je plné a doporučit mu uvolnění místa, například vymazáním cache nebo cookies v prohlížeči.

Chyba NS_ERROR_DOM_QUOTA_EXCEEDED_ERR je běžný problém při práci s Local Storage a Session Storage ve webových aplikacích. Překročení kvóty úložiště může způsobit, že aplikace nebude schopna správně fungovat, ale existuje několik způsobů, jak tuto chybu efektivně řešit. Optimalizace dat, použití jiných úložných technologií, a správná detekce dostupné kapacity jsou klíčovými kroky, jak zabránit této chybě a zajistit hladký chod vaší aplikace.