CKTIS / JavaScript
Object.isFrozen — controleren of een object bevroren is
Object.isFrozen(value) controleert of een object niet-uitbreidbaar is, de eigen eigenschappen niet configureerbaar zijn en de gegevenseigenschappen ook niet schrijfbaar zijn. De methode bevriest het object niet en controleert geneste objecten niet recursief.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Object.isFrozen(value)Object.isFrozen(value) is een statische methode die true retourneert wanneer een object geen eigen eigenschappen kan krijgen, al zijn eigen eigenschappen configurable: false hebben en de eigen gegevenseigenschappen bovendien writable: false hebben. Symbolische sleutels en niet-enumerabele eigenschappen tellen mee, maar overgeërfde eigenschappen niet.
De methode onderzoekt de toestand in plaats van die te wijzigen; gebruik Object.freeze om een object te bevriezen. Alleen Object.seal is niet voldoende als er schrijfbare gegevenseigenschappen overblijven. Een leeg object is na Object.preventExtensions echter wel bevroren, omdat het geen eigenschappen heeft die de overige voorwaarden schenden.
Een resultaat van true betekent geen diepe onveranderlijkheid. Objecten die als eigenschapswaarden zijn opgeslagen, kunnen nog steeds veranderen. Accessoreigenschappen kunnen setters behouden en getters kunnen wisselende resultaten retourneren; de test vereist niet dat ze worden verwijderd en roept de getters van een gewoon object niet aan.
Voor primitieve waarden, waaronder null en undefined, retourneert de huidige specificatie true. Bij een Proxy kan de inspectie traps activeren en een uitzondering veroorzaken. De bewerking heeft dus niet altijd geen neveneffecten.
Voorbeelden
const settings = { theme: { dark: false } };
console.log(Object.isFrozen(settings));
Object.freeze(settings);
console.log(Object.isFrozen(settings));
console.log(Object.isFrozen(settings.theme));
settings.theme.dark = true;
console.log(settings.theme.dark);
console.log(Object.isFrozen(Object.preventExtensions({})));
console.log(Object.isFrozen(null));Resultaat
false true false true true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.