---
description: convert a value to string.
---

# valueToString()

[JS](../../..) ⟩ [value](../..) ⟩ [type](../../type) ⟩ [conversion](../../type/convert) ⟩ valueToString()

{% hint style="success" %}
convert a value to its most "natural" string representation.
{% endhint %}

{% tabs %}
{% tab title="💾 程式" %}
* replit： [valueToString()](https://replit.com/@pegasusroe/valueToString#index.js),  require：[isobject](../../type/type-functions/isobject "mention")

```javascript
const { isObject } = require('./isObject.js');

// ⭐️ valueToString(value)
function valueToString(value){

    const str = String(value);

    // ------------ primitive ------------
    
    if (!isObject(value)) {
        if (typeof value === 'string') return `'${str}'`;
        return str;
    }

    // ------------ object ------------

    // array
    if (Array.isArray(value)) return '[' 
        + value.map(x => valueToString(x)).join(',')
        + ']';
    
    // Set
    if (str === '[object Set]') 
        return `{${[...value].map(x => valueToString(x)).join(', ')}}`;
    
    // Map
    if (str === '[object Map]') 
        return `{${[...value].map(p => `${p[0]}→${valueToString(p[1])}`).join(', ')}}`;
    
    // function: return its code
    if (typeof value === 'function') return value.toString();
    
    // other object, try to get its methods as well.
    let result = [];
    
    for (let key in value) {
        result.push(`${key}: ${valueToString(value[key])}`);
    }
    
    return `{${result.join(', ')}}`;
}

// export
module.exports = { valueToString };
```

💈範例：

```javascript
string               value
--------------------------------------------------
''                   ''
'yes'                'yes'
'0'                  '0'
'3'                  '3'
'+5'                 '+5'
'-4.3'               '-4.3'
--------------------------------------------------
true                 true
false                false
--------------------------------------------------
0                    0
5.6                  5.6
-7.8                 -7.8
NaN                  NaN
--------------------------------------------------
null                 null
undefined            undefined
--------------------------------------------------
[]                   []
[0]                  [ 0 ]
[4.6]                [ 4.6 ]
[2,3]                [ 2, 3 ]
[1,2,3,4]            [ [ 1, 2 ], [ 3, 4 ] ]
--------------------------------------------------
{1, 'hi'}            Set(2) { 1, 'hi' }
--------------------------------------------------
{x→0}                Map(1) { 'x' => 0 }
--------------------------------------------------
{}                   {}
{a: 2}               { a: 2 }
{a: 2, f: () => 1}   { a: 2, f: [Function: f] }
--------------------------------------------------
() => true           [Function (anonymous)]
() => 1              [Function (anonymous)]
--------------------------------------------------
```
{% endtab %}

{% tab title="💈範例" %}
* codepen ⟩ [object.toString() ?](https://codepen.io/lochiwei/pen/vYJGooO?editors=0011)
* codesandbox ⟩ [compare: \~\~, +, !!, Math.trunc](https://codesandbox.io/s/compare-math-trunc-bi2gh?file=/src/styles.css:0-232)

{% embed url="https://codesandbox.io/embed/compare-math-trunc-bi2gh?fontsize=14&hidenavigation=1&theme=dark" %}
toString(obj): first column
{% endembed %}
{% endtab %}

{% tab title="👥 相關" %}
* [helper functions](../../../../appendix/custom/helper-functions) (0.1.8)
* [str](../../prim/str "mention")
{% endtab %}
{% endtabs %}
