to-string-symbols-supported-x/src/to-string-symbols-supported-x.js

ES6 abstract ToString with Symbol conversion support.

import hasSymbols from 'has-symbol-support-x';
import isSymbol from 'is-symbol';

/* eslint-disable-next-line compat/compat */
const pToString = hasSymbols && Symbol.prototype.toString;
const isSymbolFn = typeof pToString === 'function' && isSymbol;
/** @type {Function} */
const castString = ''.constructor;

/**
 * The abstract operation ToString converts argument to a value of type String,
 * however the specification states that if the argument is a Symbol then a
 * 'TypeError' is thrown. This version also allows Symbols be converted to
 * a string. Other uncoercible exotics will still throw though.
 *
 * @param {*} [value] - The value to convert to a string.
 * @returns {string} The converted value.
 */
const toStringSymbolsSupported = function toStringSymbolsSupported(value) {
  return isSymbolFn && isSymbolFn(value) ? pToString.call(value) : castString(value);
};

export default toStringSymbolsSupported;