safe-get-nested 1.0.0

package/README.md

@@ -0,0 +1,54 @@
+# safe-get-nested
+
+A minimalist utility to fetch values from deeply nested objects without the risk of throwing `Cannot read property of undefined` error.
+
+## install 
+
+```bash
+npm i safe-get-nested
+```
+
+## Usage
+
+Supports both [ES Modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) (import) and [CommonJs](https://en.wikipedia.org/wiki/CommonJS) (require).
+
+### 1. ESM (Modern)
+```javascript
+import { safeGet } from 'safe-get-nested';
+
+const user = { profile: { address: { city: 'San Francisco' } } };
+console.log(safeGet(user, 'profile.address.city')); // 'San Francisco'
+```
+
+### 2. CommonJS (Legacy)
+```javascript
+const safeGet = require('safe-get-nested');
+
+const user = { profile: null };
+console.log(safeGet(user, 'profile.address.city')); // undefined (No Error!)
+```
+
+## Quick test / Examples
+```
+const data = {
+    a: {
+        b: {
+            c: 42
+        }
+    }
+};
+
+// Valid path
+safeGet(data, 'a.b.c');    // Result: 42 ✅
+
+// Broken path
+safeGet(data, 'a.z.c');    // Result: undefined ✅
+
+// Null middle-man
+const nullData = { a: null };
+safeGet(nullData, 'a.b');  // Result: undefined ✅
+```
+
+## Why? 🤔
+
+Standard JS throws errors when accessing properties of `null` or `undefined`. This utility acts as a safe **Parsing** layer that traverses the object tree and returns `undefined` as soon as it hits a dead end.

package/index.esm.js

@@ -0,0 +1,11 @@
+export function safeGet(obj, path) {
+    const keys = path.split('.');
+    let current = obj;
+    for (let i = 0; i < keys.length; i++) {
+        if (current === null || typeof(current) !== 'object')
+            return undefined;
+        current = current[keys[i]];
+    }
+
+    return current;
+}

package/index.js

@@ -0,0 +1,13 @@
+function safeGet(obj, path) {
+    const keys = path.split('.');
+    let current = obj;
+    for (let i = 0; i < keys.length; i++) {
+        if (current === null || typeof(current) !== 'object')
+            return undefined;
+        current = current[keys[i]];
+    }
+
+    return current;
+}
+
+module.exports = safeGet;

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "safe-get-nested",
+  "version": "1.0.0",
+  "description": "A simple utility to take nested object value with no error",
+  "main": "index.js",
+  "module": "index.esm.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/John-fried/safe-get-nested.git"
+  },
+  "keywords": ["util", "simple", "utility", "tools"],
+  "author": "john-fried",
+  "license": "MIT"
+}