Add methods for own entries and values to object.js

[Pisces] / symbol.js

diff --git a/symbol.js b/symbol.js
index 514b5262c7b1bb844aa326a6625bf9b4239a28ea..2bd37173fea849be70108d4e8991eb6d08ad918c 100644 (file)
--- a/symbol.js
+++ b/symbol.js
@@ -7,16 +7,45 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at <https://mozilla.org/MPL/2.0/>.
 
-import { makeCallable } from "./function.js";
-import { getOwnPropertyDescriptor } from "./object.js";
+import { createCallableFunction } from "./function.js";
 
 /**
  * Returns the description for the provided symbol.
  *
  * ※ This is effectively an alias for the `Symbol::description`
  * getter.
+ *
+ * ☡ This function throws if the provided argument is not a symbol.
+ */
+export const getSymbolDescription = createCallableFunction(
+  Object.getOwnPropertyDescriptor(Symbol.prototype, "description").get,
+  { name: "getSymbolDescription" },
+);
+
+/**
+ * Returns a string representation of the provided symbol.
+ *
+ * ※ Use `getSymbolDescription` instead if you just want the text
+ * description of a symbol.
+ *
+ * ※ This is effectively an alias for the `Symbol::toString`.
+ *
+ * ☡ This function throws if the provided argument is not a symbol.
+ */
+export const symbolToString = createCallableFunction(
+  Symbol.prototype.toString,
+  { name: "symbolToString" },
+);
+
+/**
+ * Returns the value of the provided symbol.
+ *
+ * ※ This is effectively an alias for the `Symbol::valueOf`.
+ *
+ * ☡ This function throws if the provided argument is not a symbol and
+ * does not have a `[[SymbolData]]` slot.
  */
-export const getSymbolDescription = makeCallable(
-  getOwnPropertyDescriptor(Symbol.prototype, "description").get,
-  "getSymbolDescription",
+export const symbolValue = createCallableFunction(
+  Symbol.prototype.valueOf,
+  { name: "symbolValue" },
 );