1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
---
title: Array.prototype.join()
slug: Web/JavaScript/Reference/Global_Objects/Array/join
tags:
- JavaScript
- Prototipo
- Referencia
- Vector
- metodo
translation_of: Web/JavaScript/Reference/Global_Objects/Array/join
---
<div>{{JSRef}}</div>
<p>O método <code><strong>join()</strong></code> cria e devolve uma <em>string</em> ao concatenar todos os elementos numa <em>array</em> (ou <a href="/en-US/docs/Web/JavaScript/Guide/Indexed_collections#Working_with_array-like_objects">objeto como um vetor / matriz</a>) numa cadeia separada por vírgulas ou outro separador especificado. Se a <em>array</em> tem um só item, esse item é devolvido sem o uso do separador.</p>
<div>{{EmbedInteractiveExample("pages/js/array-join.html")}}</div>
<h2 id="Sintaxe">Sintaxe</h2>
<pre class="syntaxbox notranslate"><var>vec</var>.join([<var>separador</var>])</pre>
<h3 id="Parâmetros">Parâmetros</h3>
<dl>
<dt><code>separador</code> {{optional_inline}}</dt>
<dd>Especifica uma <em>string</em> (cadeia de caracteres) para separar cada elemento do vetor. O separador é convertido em cadeia se for necessário. Se for omitido, os elementos serão separados por virgulas (","). Se <code>separador</code> é uma cadeia vazia, todos os elementos são unidos sem qualquer caráter entre eles.</dd>
</dl>
<h3 id="Resultado">Resultado</h3>
<p>Uma cadeia (de caracteres) com todos os elementos do vetor unidos. Se <code><em>vec</em>.length</code> é <code>0</code>, é devolvida uma cadeia vazia.</p>
<h2 id="Descrição">Descrição</h2>
<p>As conversões de todos os elementos do vetor para cadeias (de caracteres) são unidas numa única cadeia.</p>
<p>Caso algum elemento seja <code>undefined</code>, <code>null</code> ou um vetor vazio <code>[]</code>, este será convertido numa cadeia vazia.</p>
<h2 id="Exemplos">Exemplos</h2>
<h3 id="Juntar_um_vetor_de_quatro_formas_diferentes">Juntar um vetor de quatro formas diferentes</h3>
<p>O exemplo que se segue cria um vetor, <code>a</code>, com três elementos, depois disso une o vetor quatro vezes: usando o separador predefinido, uma vírgula e um espaço, o símbolo mais, e finalmente uma cadeia (de caracteres) vazia.</p>
<pre class="brush: js notranslate">var a = ['Vento', 'Chuva', 'Fogo'];
a.join(); // 'Vento,Chuva,Fogo'
a.join(', '); // 'Vento, Chuva, Fogo'
a.join(' + '); // 'Vento + Chuva + Fogo'
a.join(''); // 'VentoChuvaFogo'</pre>
<h3 id="Juntar_um_objeto_como_vetor">Juntar um objeto como vetor</h3>
<p>O seguinte exemplo junta um objeto como vetor (<code><a href="https://wiki.developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/arguments">arguments</a></code>), ao chamar {{jsxref("Function.prototype.call")}} no <code>Array.prototype.join</code>.</p>
<pre class="brush: js notranslate">function f(a, b, c) {
var s = Array.prototype.join.call(arguments);
console.log(s); // '<span class="message-body-wrapper"><span class="message-flex-body"><span class="devtools-monospace message-body"><span class="objectBox objectBox-string">1,a,true'</span></span></span></span>
}
f(1, 'a', true);
// valor devolvido: "1,a,true"
</pre>
<h2 id="Especificações">Especificações</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Especificação</th>
</tr>
<tr>
<td>{{SpecName('ESDraft', '#sec-array.prototype.join', 'Array.prototype.join')}}</td>
</tr>
</tbody>
</table>
<h2 id="Compatibilidade">Compatibilidade</h2>
<p>{{Compat("javascript.builtins.Array.join")}}</p>
<h2 id="Veja_também">Veja também</h2>
<ul>
<li>{{jsxref("String.prototype.split()")}}</li>
<li>{{jsxref("Array.prototype.toString()")}}</li>
<li>{{jsxref("TypedArray.prototype.join()")}}</li>
</ul>
|
