66 lines
2.1 KiB
JavaScript
Raw Normal View History

2026-05-31 13:21:13 +02:00
import { isUnsafeProperty } from "../../_internal/isUnsafeProperty.mjs";
import { isDeepKey } from "../_internal/isDeepKey.mjs";
import { toKey } from "../_internal/toKey.mjs";
import { toPath } from "../util/toPath.mjs";
//#region src/compat/object/get.ts
/**
* Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
*
* @param {any} object - The object to query.
* @param {PropertyKey | readonly PropertyKey[]} path - The path of the property to get.
* @param {any} [defaultValue] - The value returned if the resolved value is undefined.
* @returns {any} Returns the resolved value.
*
* @example
* const object = { a: { b: { c: 1 } } };
* get(object, 'a.b.c');
* // => 1
*
* get(object, ['a', 'b', 'c']);
* // => 1
*
* get(object, 'a.b.d', 'default');
* // => 'default'
*/
function get(object, path, defaultValue) {
if (object == null) return defaultValue;
switch (typeof path) {
case "string": {
if (isUnsafeProperty(path)) return defaultValue;
const result = object[path];
if (result === void 0) if (isDeepKey(path)) return get(object, toPath(path), defaultValue);
else return defaultValue;
return result;
}
case "number":
case "symbol": {
if (typeof path === "number") path = toKey(path);
const result = object[path];
if (result === void 0) return defaultValue;
return result;
}
default: {
if (Array.isArray(path)) return getWithPath(object, path, defaultValue);
if (Object.is(path?.valueOf(), -0)) path = "-0";
else path = String(path);
if (isUnsafeProperty(path)) return defaultValue;
const result = object[path];
if (result === void 0) return defaultValue;
return result;
}
}
}
function getWithPath(object, path, defaultValue) {
if (path.length === 0) return defaultValue;
let current = object;
for (let index = 0; index < path.length; index++) {
if (current == null) return defaultValue;
if (isUnsafeProperty(path[index])) return defaultValue;
current = current[path[index]];
}
if (current === void 0) return defaultValue;
return current;
}
//#endregion
export { get };