updeep-remeda/esm/freeze.js

55 lines
1.5 KiB
JavaScript
Raw Normal View History

2023-01-03 18:51:35 +00:00
function isFreezable(object) {
if (object === null)
return false;
if (object instanceof RegExp)
return false;
if (object instanceof ArrayBuffer)
return false;
return Array.isArray(object) || typeof object === "object";
}
function needsFreezing(object) {
return isFreezable(object) && !Object.isFrozen(object);
}
function recur(object) {
Object.freeze(object);
Object.keys(object).forEach((key) => {
const value = object[key];
if (needsFreezing(value)) {
recur(value);
}
});
return object;
}
/**
* Deeply freeze a plain javascript object.
*
* If `process.env.NODE_ENV === 'production'`, this returns the original object
* without freezing.
*
* Or if `process.env.UPDEEP_MODE === 'dangerously_never_freeze'`, this returns the original object
* without freezing.
*
* If in a browser and built without replacing process, never freeze.
*
* @function
* @sig a -> a
* @param object Object to freeze.
* @return Frozen object, unless in production, then the same object.
*/
function freeze(object) {
if (typeof process === "undefined") {
return object;
}
if (process.env.NODE_ENV === "production") {
return object;
}
if (process.env.UPDEEP_MODE === "dangerously_never_freeze") {
return object;
}
if (needsFreezing(object)) {
recur(object);
}
return object;
}
export default freeze;
//# sourceMappingURL=freeze.js.map