uncurried-intrinsics 1.0.0 → 1.0.2

package/README.md

@@ -15,70 +15,100 @@ npm install uncurry-intrinsics
 ## Usage
 
 ```javascript
-var uncurryIntrinsic = require("uncurry-intrinsics");
+var uncurryIntrinsic = require("uncurry-intrinsics")
 
 // Get uncurried Array.prototype.slice
-var slice = uncurryIntrinsic("Array.prototype.slice");
-slice([1, 2, 3, 4, 5], 1, 3); // [2, 3]
+var slice = uncurryIntrinsic("Array.prototype.slice")
+slice([1, 2, 3, 4, 5], 1, 3) // [2, 3]
 
 // Get uncurried String.prototype.split
-var split = uncurryIntrinsic("String.prototype.split");
-split("foo-bar-baz", "-"); // ["foo", "bar", "baz"]
+var split = uncurryIntrinsic("String.prototype.split")
+split("foo-bar-baz", "-") // ["foo", "bar", "baz"]
 
 // Get uncurried Array.prototype.map
-var map = uncurryIntrinsic("Array.prototype.map");
-var doubled = map([1, 2, 3], function(x) { return x * 2; }); // [2, 4, 6]
+var map = uncurryIntrinsic("Array.prototype.map")
+var doubled = map([1, 2, 3], function (x) {
+  return x * 2
+}) // [2, 4, 6]
 ```
 
 ## API
 
-### `uncurryIntrinsic(intrinsicName)`
+### `uncurryIntrinsic(intrinsicName[, allowMissing])`
 
 Gets an intrinsic by name and returns its uncurried version where `this` becomes the first parameter.
 
 **Parameters:**
+
 - `intrinsicName` (string): The name of the intrinsic to get and uncurry (e.g., `"Array.prototype.slice"`)
+- `allowMissing` (boolean, optional): If `true`, returns `null` or `undefined` for missing intrinsics instead of throwing an error. Default: `false`
 
 **Returns:**
-- (Function): The uncurried intrinsic function
+
+- (Function|null|undefined): The uncurried intrinsic function, or `null`/`undefined` if `allowMissing` is `true` and the intrinsic doesn't exist
+
+**Throws:**
+
+- Error if the intrinsic is not available and `allowMissing` is `false`
 
 ## Examples
 
 ### Array methods
 
 ```javascript
-var uncurryIntrinsic = require("uncurry-intrinsics");
+var uncurryIntrinsic = require("uncurry-intrinsics")
 
-var push = uncurryIntrinsic("Array.prototype.push");
-var join = uncurryIntrinsic("Array.prototype.join");
+var push = uncurryIntrinsic("Array.prototype.push")
+var join = uncurryIntrinsic("Array.prototype.join")
 
-var arr = [1, 2, 3];
-push(arr, 4, 5); // 5
-join(arr, ", "); // "1, 2, 3, 4, 5"
+var arr = [1, 2, 3]
+push(arr, 4, 5) // 5
+join(arr, ", ") // "1, 2, 3, 4, 5"
 ```
 
 ### String methods
 
 ```javascript
-var uncurryIntrinsic = require("uncurry-intrinsics");
+var uncurryIntrinsic = require("uncurry-intrinsics")
 
-var charAt = uncurryIntrinsic("String.prototype.charAt");
-var toUpperCase = uncurryIntrinsic("String.prototype.toUpperCase");
+var charAt = uncurryIntrinsic("String.prototype.charAt")
+var toUpperCase = uncurryIntrinsic("String.prototype.toUpperCase")
 
-charAt("hello", 0); // "h"
-toUpperCase("hello"); // "HELLO"
+charAt("hello", 0) // "h"
+toUpperCase("hello") // "HELLO"
 ```
 
 ### Object methods
 
 ```javascript
-var uncurryIntrinsic = require("uncurry-intrinsics");
+var uncurryIntrinsic = require("uncurry-intrinsics")
 
-var hasOwnProperty = uncurryIntrinsic("Object.prototype.hasOwnProperty");
+var hasOwnProperty = uncurryIntrinsic("Object.prototype.hasOwnProperty")
 
-var obj = { foo: 1, bar: 2 };
-hasOwnProperty(obj, "foo"); // true
-hasOwnProperty(obj, "baz"); // false
+var obj = { foo: 1, bar: 2 }
+hasOwnProperty(obj, "foo") // true
+hasOwnProperty(obj, "baz") // false
+```
+
+### Handling missing intrinsics
+
+```javascript
+var uncurryIntrinsic = require("uncurry-intrinsics")
+
+// Throws an error if the intrinsic doesn't exist
+try {
+  var missing = uncurryIntrinsic("NonExistent.prototype.method")
+} catch (e) {
+  console.log(e.message) // 'Intrinsic "NonExistent.prototype.method" is not available'
+}
+
+// Returns null/undefined if allowMissing is true
+var maybeExists = uncurryIntrinsic("Reflect.apply", true)
+if (maybeExists) {
+  // Use the intrinsic
+} else {
+  // Handle missing intrinsic
+}
 ```
 
 ## See Also
@@ -88,4 +118,4 @@ hasOwnProperty(obj, "baz"); // false
 
 ## License
 
-MIT
+MIT

package/index.js

@@ -6,13 +6,18 @@ var uncurryThis = require("uncurry-x")
 /**
  * Gets an intrinsic and returns its uncurried version
  * @param {string} intrinsicName - The name of the intrinsic (e.g., "Array.prototype.slice")
- * @param {boolean} allowMissing - Whether to allow missing intrinsics
- * @returns {Function} The uncurried intrinsic function
+ * @param {boolean} [allowMissing=false] - Whether to allow missing intrinsics (returns null/undefined instead of throwing)
+ * @returns {Function|null|undefined} The uncurried intrinsic function, or null/undefined if allowMissing is true and intrinsic doesn't exist
+ * @throws {Error} If the intrinsic is not available and allowMissing is false, or if GetIntrinsic fails
  */
 function uncurryIntrinsic(intrinsicName, allowMissing) {
   var intrinsic
   try {
-    intrinsic = GetIntrinsic(intrinsicName, allowMissing)
+    if (allowMissing != null) {
+      intrinsic = GetIntrinsic(intrinsicName, allowMissing)
+    } else {
+      intrinsic = GetIntrinsic(intrinsicName)
+    }
   } catch (e) {
     throw new Error(
       'Failed to get intrinsic "' + intrinsicName + '": ' + e.message

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uncurried-intrinsics",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Combines es-intrinsic-cache and uncurry-x to get and uncurry JavaScript intrinsics in one step",
   "keywords": [
     "intrinsics",