diff options
Diffstat (limited to 'files/pt-br/web/javascript/reference/global_objects/symbol/species/index.html')
-rw-r--r-- | files/pt-br/web/javascript/reference/global_objects/symbol/species/index.html | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/files/pt-br/web/javascript/reference/global_objects/symbol/species/index.html b/files/pt-br/web/javascript/reference/global_objects/symbol/species/index.html new file mode 100644 index 0000000000..fcf636c175 --- /dev/null +++ b/files/pt-br/web/javascript/reference/global_objects/symbol/species/index.html @@ -0,0 +1,63 @@ +--- +title: Symbol.species +slug: Web/JavaScript/Reference/Global_Objects/Symbol/species +translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/species +--- +<div>{{JSRef}}</div> + +<p>O símbolo <code><strong>Symbol.species</strong></code> especifica uma propriedade valor-função que a função construtora usa para criar objetos derivados.</p> + +<div>{{EmbedInteractiveExample("pages/js/symbol-species.html")}}</div> + + + +<h2 id="Descrição">Descrição</h2> + +<p>A propriedade acessora de espécies permite que subclasses substituam o construtor padrão para objetos.</p> + +<p>{{js_property_attributes(0,0,0)}}</p> + +<h2 id="Exemplos">Exemplos</h2> + +<h3 id="Usando_espécies">Usando espécies</h3> + +<p>Você pode querer que retorne objetos {{jsxref("Array")}} em sua class derivada de array <code>MyArray</code>. Por exemplo, quando usar métodos tais como {{jsxref("Array.map", "map()")}} que retorna o construtor padrão, você quer que esses métodos retornem um objeto <code>Array</code> pai, em vez do objeto <code>MyArray</code>. Esses símbolos espécies permitem que você fala isso:</p> + +<pre class="brush: js notranslate">class MyArray extends Array { + // Substitui espécies para a Array pai construtora + static get [Symbol.species]() { return Array; } +} +let a = new MyArray(1,2,3); +let mapped = a.map(x => x * x); + +console.log(mapped instanceof MyArray); // false +console.log(mapped instanceof Array); // true +</pre> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Especificação</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-symbol.species', 'Symbol.species')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> + + + +<p>{{Compat("javascript.builtins.Symbol.species")}}</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>{{jsxref("Map.@@species", "Map[@@species]")}}</li> + <li>{{jsxref("Set.@@species", "Set[@@species]")}}</li> +</ul> |