diff options
Diffstat (limited to 'files/pt-pt/web/javascript/reference')
61 files changed, 0 insertions, 11776 deletions
diff --git a/files/pt-pt/web/javascript/reference/about/index.html b/files/pt-pt/web/javascript/reference/about/index.html deleted file mode 100644 index 2f9aaa49ac..0000000000 --- a/files/pt-pt/web/javascript/reference/about/index.html +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Sobre a referência de JavaScript -slug: Web/JavaScript/Reference/About -tags: - - JavaScript -translation_of: Web/JavaScript/Reference/About -original_slug: Web/JavaScript/Reference/Sobre ---- -<div>{{JsSidebar}}</div> - -<p>The JavaScript reference serves as a repository of facts about the JavaScript language. The entire language is described here in detail. As you write JavaScript code, you'll refer to these pages often (thus the title "JavaScript reference"). If you're learning JavaScript, or need help understanding some of its capabilities or features, check out the <a href="/en-US/docs/Web/JavaScript/Guide">JavaScript guide</a>.</p> - -<p>The JavaScript language is intended to be used within some larger environment, be it a browser, server-side scripts, or similar. For the most part, this reference attempts to be environment-agnostic and does not target a web browser environment.</p> - -<h2 id="Onde_encontrar_informação_sobre_JavaScript">Onde encontrar informação sobre JavaScript</h2> - -<p>JavaScript documentation of core language features (pure <a href="/en-US/docs/Web/JavaScript/Language_Resources">ECMAScript</a>, for the most part) includes the following:</p> - -<ul> - <li><a href="/pt-PT/docs/Web/JavaScript/Guia">Guia de JavaScript</a></li> - <li><a href="/pt-PT/docs/Web/JavaScript/Reference">Referência JavaScript</a></li> -</ul> - -<p>If you are new to JavaScript, start with the <a href="/en-US/docs/Web/JavaScript/Guide">guide</a>. Once you have a firm grasp of the fundamentals, you can use the <a href="/en-US/docs/Web/JavaScript/Reference">reference</a> to get more details on individual objects and language constructs.</p> - -<h2 id="Estrutura_da_referência">Estrutura da referência</h2> - -<p>In the JavaScript reference you can find the following chapters:</p> - -<dl> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects">Standard built-in objects</a></dt> - <dd>This chapter documents all the JavaScript standard built-in objects, along with their methods and properties.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Statements">Statements and declarations</a></dt> - <dd>JavaScript applications consist of statements with an appropriate syntax. A single statement may span multiple lines. Multiple statements may occur on a single line if each statement is separated by a semicolon. This isn't a keyword, but a group of keywords.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Operators">Expressions and operators</a></dt> - <dd>This chapter documents all the JavaScript language operators, expressions and keywords.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Functions">Functions</a></dt> - <dd>Chapter about JavaScript functions.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Classes">Classes</a></dt> - <dd>Chapter about JavaScript classes introduced in ECMAScript 6.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Errors">Errors</a></dt> - <dd>Chapter about specific errors, exceptions and warnings thrown by JavaScript.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/New_in_JavaScript">New in JavaScript</a></dt> - <dd>Chapter about JavaScript version history.</dd> -</dl> - -<h3 id="Mais_páginas_de_referência">Mais páginas de referência</h3> - -<ul> - <li><a href="https://developer.mozilla.org/pt-PT/docs/Web/JavaScript/Reference/Funcionalidades_obsoletas">Funcionalidades obsoletas</a></li> - <li><a href="/pt-PT/docs/Web/JavaScript/Reference/Gramatica_lexical">Gramática Lexical</a></li> - <li><a href="/pt-PT/docs/Web/JavaScript/Estruturas_de_dados">Tipos de dados e estruturas de dados</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/classes/index.html b/files/pt-pt/web/javascript/reference/classes/index.html deleted file mode 100644 index 03ff413025..0000000000 --- a/files/pt-pt/web/javascript/reference/classes/index.html +++ /dev/null @@ -1,437 +0,0 @@ ---- -title: Classes -slug: Web/JavaScript/Reference/Classes -tags: - - Classes - - Construtores - - ECMAScript 2015 - - Herança - - Intermedio - - JavaScript -translation_of: Web/JavaScript/Reference/Classes ---- -<div>{{JsSidebar("Classes")}}</div> - -<p>Classes JavaScript , introduzidas no ECMAScript de 2015, são principalemente syntactical sugar sobre a herança baseada em prototipagem do JavaScript. A sintaxe de classe <strong>não </strong>introduz no JavaScript nenhum novo modelo de herança do paradigma das linguagens orientado a objetos .</p> - -<h2 id="Definição_de_classes">Definição de classes</h2> - -<p>As classes são na realidade "<a href="/en-US/docs/Web/JavaScript/Reference/Functions">funções</a> especiais", e, tal como você pode definir o <a href="/en-US/docs/Web/JavaScript/Reference/Operators/function">expressões de funções</a> e <a href="/en-US/docs/Web/JavaScript/Reference/Statements/function">declarações de funções</a>, a sintaxe de classe tem dois componentes: <a href="/en-US/docs/Web/JavaScript/Reference/Operators/class">expressões de classes</a> e a <a href="/en-US/docs/Web/JavaScript/Reference/Statements/class">declaração da classe</a>.</p> - -<h3 id="Declaração_de_classes">Declaração de classes</h3> - -<p>Uma forma de definir uma classe é usar uma <strong>declaração de classe</strong>. Para declarar uma classe, utiliza-se a palavra reservada <code>class</code> seguida do nome da classe ("Rectangle" no seguinte exemplo).</p> - -<pre class="brush: js">class Rectangle { - constructor(height, width) { - this.height = height; - this.width = width; - } -}</pre> - -<h4 id="Hoisting">Hoisting</h4> - -<p>Uma diferença importante entre a <strong>declaração de funções</strong> e a <strong>declaração de classes</strong> é que a declaração de funções são {{Glossary("Hoisting", "hoisted")}} e a declaração de classes não. É preciso primeiro declarar a classe e só depois aceder-lhe, caso contrário, como no código que se segue, será lançada uma {{jsxref("ReferenceError")}}:</p> - -<pre class="brush: js example-bad">var p = new Rectangle(); // ReferenceError - -class Rectangle {} -</pre> - -<h3 id="Expressão_de_Classe">Expressão de Classe</h3> - -<p>A <strong>expressão de classe</strong> é outra forma de definir uma classe. As expressões de classes podem ter nome o ser anónimas. O nome dado a uma expressão de classe é local ao corpo da classe. (ainda assim pode ser obtido através do propriedade <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/name">.name</a> da classe (não da instância) )</p> - -<pre class="brush: js">// unnamed -var Rectangle = class { - constructor(height, width) { - this.height = height; - this.width = width; - } -}; - -// named -var Rectangle = class Rectangle { - constructor(height, width) { - this.height = height; - this.width = width; - } -}; -</pre> - -<div class="blockIndicator note"> -<p><strong>Nota:</strong> <strong>Expressões </strong>de classes também padecem da mesma situação de hoisting mencionada para as <strong>declarações </strong>de classes.</p> -</div> - -<h2 id="Definição_de_corpo_de_classe_e_de_método">Definição de corpo de classe e de método</h2> - -<p>O corpo da classe é a parte que está entre as chavetas <code>{}</code>. É aqui que são definidos os membros da classe, tais como, métodos e construtores.</p> - -<h3 id="Strict_mode_-_modo_estrito">Strict mode - modo estrito</h3> - -<p>Os corpos da <em>declaração de classes </em>e da <em>expressão de classes </em>são executados em <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Strict_mode">strict mode</a> i.e. construtor, métodos estáticos e de prototipo, funções getter e setter são executadas em modo estrito.</p> - -<h3 id="Construtor_(constructor)">Construtor (<em>constructor</em>)</h3> - -<p>O método <code><a href="/en-US/docs/Web/JavaScript/Reference/Classes/constructor">constructor</a></code> é um método especial para criar e inicializar um objto criado de uma <code>class</code>. Numa classe, apenas pode existir um método especial com o nome "constructor". Se a classe tiver mais do que uma occorrência de um método <code>constructor</code> será lançada uma {{jsxref("SyntaxError")}}.</p> - -<p>Um construtor pode utlizar a palavra reservada <code>super</code> para invocar o construtor da classe pai.</p> - -<h3 id="Métodos_de_Prototype">Métodos de Prototype </h3> - -<p>Ver também <a href="/en-US/docs/Web/JavaScript/Reference/Functions/Method_definitions">definição de métodos</a>.</p> - -<pre class="brush: js">class Rectangle { - constructor(height, width) { - this.height = height; - this.width = width; - } - // Getter - get area() { - return this.calcArea(); - } - // Method - calcArea() { - return this.height * this.width; - } -} - -const square = new Rectangle(10, 10); - -console.log(square.area); // 100</pre> - -<h3 id="Métodos_estáticos">Métodos estáticos</h3> - -<p>A palavra reservada <code><a href="/en-US/docs/Web/JavaScript/Reference/Classes/static">static</a></code> define um método como estático para uma classe. Os métodos estáticos são chamados sem <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Introduction_to_Object-Oriented_JavaScript#The_object_(class_instance)" title='An example of class instance is "var john = new Person();"'>instanciarem </a>as suas classes e <strong>não podem </strong>ser chamados a partir de instâncias da classe. Os métodos estáticos são frequentemente utilizados para criar funções utilitárias para uma aplicação.</p> - -<pre class="brush: js">class Point { - constructor(x, y) { - this.x = x; - this.y = y; - } - - static distance(a, b) { - const dx = a.x - b.x; - const dy = a.y - b.y; - - return Math.hypot(dx, dy); - } -} - -const p1 = new Point(5, 5); -const p2 = new Point(10, 10); - -console.log(Point.distance(p1, p2)); // 7.0710678118654755</pre> - -<h3 id="Boxing_com_métodos_estáticos_e_de_protótipo">Boxing com métodos estáticos e de protótipo </h3> - -<p>Quando um método estático é chamado sem um objeto correspondente ao "this", o valor do "this" é então <code>undefined</code> dentro do método chamado. O comportamento será o mesmo, mesmo que a diretiva <code>"use strict"</code> não esteja presente, isto porque o código contido no limite sintático do corpo da <code>class</code> é sempre executado em modo estrito.</p> - -<pre class="brush: js">class Animal { - speak() { - return this; - } - static eat() { - return this; - } -} - -let obj = new Animal(); -obj.speak(); // Animal {} -let speak = obj.speak; -speak(); // undefined - -Animal.eat() // class Animal -let eat = Animal.eat; -eat(); // undefined</pre> - -<p> </p> - -<p>Se o texto acima for escrito usando a sintaxe tradicional baseada em função, o autooboxing ocorrerá nas chamadas de método no modo não estrito com base no valor inicial do <em>this</em>. Se o valor inicial for <code>undefined</code>, isso será definido para o objeto global.</p> - -<p>Autoboxing não acontecerá no modo estrito, o valor do <em>this </em>permanece como passado ao método.</p> - -<p> </p> - -<pre><code>function Animal() { } - -Animal.prototype.speak = function() { - return this; -} - -Animal.eat = function() { - return this; -} - -let obj = new Animal(); -let speak = obj.speak; -speak(); // global object - -let eat = Animal.eat; -eat(); // global object</code></pre> - -<h3 id="Propriedades_de_instância">Propriedades de instância</h3> - -<p>Propriedades de instância devem ser definidas dentro de métodos da classe:</p> - -<pre><code>class Rectangle { - constructor(height, width) { - this.height = height; - this.width = width; - } -}</code></pre> - -<p>Propriedades estáticas da classe e propriedades de dados do protótipo devem ser definidas fora da declaração do ClassBody:</p> - -<pre><code>Rectangle.staticWidth = 20; -Rectangle.prototype.prototypeWidth = 25;</code></pre> - -<h3 id="Declaração_de_campos_(Field)">Declaração de campos (<em>Field</em>)</h3> - -<div class="blockIndicator warning"> -<p>Declarações de campo públicos e privados são uma <a href="https://github.com/tc39/proposal-class-fields">funcionalidade experimental (stage 3)</a> proposta no <a href="https://tc39.github.io/beta/">TC39</a>, o comité de padrões JavaScript. O suporte nos navegadores é limitado, mas a funcionalidade pode ser usada por meio de uma etapa de <em>build</em> com sistemas como o <a href="https://babeljs.io/">Babel</a>.</p> -</div> - -<h4 id="Declaração_de_campos_(field_)_públicos">Declaração de campos (<em>field </em>) públicos</h4> - -<p>Com a sintaxe de declaração de campo JavaScript, o exemplo acima pode ser escrito como:</p> - -<pre><code>class Rectangle { - height = 0; - width; - constructor(height, width) { - this.height = height; - this.width = width; - } -}</code></pre> - -<p> </p> - -<p>Ao declarar campos antecipadamente, as definições de classe se tornam mais autodocumentadas e os campos estão sempre presentes.</p> - -<p>Como visto acima, os campos podem ser declarados com ou sem um valor padrão.</p> - -<p> </p> - -<h4 id="Declaração_de_campos_(field)_privados">Declaração de campos (<em>field</em>) privados </h4> - -<p>Usando campos privados, a definição pode ser refinada como abaixo.</p> - -<pre><code>class Rectangle { - #height = 0; - #width; - constructor(height, width) { - this.#height = height; - this.#width = width; - } -}</code></pre> - -<p> </p> - -<p>É um erro referenciar campos privados de fora da classe. eles só podem ser lidos ou escritos dentro do corpo da classe. Ao definir coisas que não são visíveis fora da classe, você garante que os utilizadores das suas classes não dependeram de estruturas internas, que podem mudar a versão para a versão.</p> - -<div class="blockIndicator note"> -<p>Campos privados só podem ser declarados antecipadamente numa declaração de campo.</p> -</div> - -<p>Os campos privados não podem ser criados posteriormente através da sua afetação, como se pode fazer com as propriedades normais.</p> - -<p> </p> - -<p> </p> - -<p> </p> - -<p> </p> - -<p> </p> - -<p> </p> - -<h2 id="Derivação_de_classes_com_extends">Derivação de classes com <code>extends</code></h2> - -<p>A palavra reservada <code><a href="/en-US/docs/Web/JavaScript/Reference/Classes/extends">extends</a></code> é utilizada na <em>declaração de classes </em>ou na <em>expressão de classes</em> para criar uma classe filha ou derivada de outra .</p> - -<pre class="brush: js">class Animal { - constructor(name) { - this.name = name; - } - - speak() { - console.log(this.name + ' makes a noise.'); - } -} - -class Dog extends Animal { - speak() { - console.log(this.name + ' barks.'); - } -} - -var d = new Dog('Mitzie'); -d.speak(); // Mitzie barks. -</pre> - -<p>Se houver um construtor presente numa classe derivada, este precisa de chamar super() antes de utilizar o "this".</p> - -<p>A tradicionais "classes" function-based podem também ser extendidas:</p> - -<pre class="brush: js">function Animal (name) { - this.name = name; -} - -Animal.prototype.speak = function () { - console.log(this.name + ' makes a noise.'); -} - -class Dog extends Animal { - speak() { - console.log(this.name + ' barks.'); - } -} - -var d = new Dog('Mitzie'); -d.speak(); // Mitzie barks. -</pre> - -<p>É de notar que uma classe não pode estender um objeto regular (non-constructible). Alternativamente, para se criar herança a partir de um objeto regular, deve ser usado {{jsxref("Object.setPrototypeOf()")}}:</p> - -<pre class="brush: js">var Animal = { - speak() { - console.log(this.name + ' makes a noise.'); - } -}; - -class Dog { - constructor(name) { - this.name = name; - } -} - -// If you do not do this you will get a TypeError when you invoke speak -Object.setPrototypeOf(Dog.prototype, Animal); - -var d = new Dog('Mitzie'); -d.speak(); // Mitzie makes a noise. -</pre> - -<h2 id="Espécies">Espécies</h2> - -<p>Se quiser devolver um objeto do tipo {{jsxref("Array")}} na sua classe derivada <code>MyArray</code>. O padrão espécies permite-lhe redefinir o construtor por omissão.</p> - -<p>Por exemplo, na utilização de um método como o {{jsxref("Array.map", "map()")}}, o qual devolve o construtor por omissão, querer-se-á que estes métodos devolvam um objeto pai do tipo <code>Array</code>, em vez de um objeto <code>MyArray</code>. O símbolo {{jsxref("Symbol.species")}} permite fazer isto:</p> - -<pre class="brush: js">class MyArray extends Array { - // Overwrite species to the parent Array constructor - static get [Symbol.species]() { return Array; } -} - -var a = new MyArray(1,2,3); -var mapped = a.map(x => x * x); - -console.log(mapped instanceof MyArray); // false -console.log(mapped instanceof Array); // true -</pre> - -<h2 id="Chamadas_à_super_classe_com_super">Chamadas à super classe com <code>super</code></h2> - -<p>A palavra reservada <code><a href="/en-US/docs/Web/JavaScript/Reference/Operators/super">super</a></code> é utilizada para chamar funções no objeto pai do objeto.</p> - -<pre class="brush: js">class Cat { - constructor(name) { - this.name = name; - } - - speak() { - console.log(this.name + ' makes a noise.'); - } -} - -class Lion extends Cat { - speak() { - super.speak(); - console.log(this.name + ' roars.'); - } -} - -var l = new Lion('Fuzzy'); -l.speak(); -// Fuzzy makes a noise. -// Fuzzy roars. - -</pre> - -<h2 id="Mix-ins">Mix-ins</h2> - -<p>A subclasses abstratas ou <em>mix-ins</em> são templates para classes. Uma classe ECMAScript apenas pode ter uma única superclasse, Portanto, múltiplas heranças de classes de ferramentas, por exemplo, não são possíveis. A funcionalidade deve ser fornecida pela superclasse.</p> - -<p>Uma função com uma superclasse como entrada e uma subclasse estendendo aquela superclasse como saída pode ser usada para implementar mix-ins no ECMAScript.:</p> - -<pre class="brush: js">var calculatorMixin = Base => class extends Base { - calc() { } -}; - -var randomizerMixin = Base => class extends Base { - randomize() { } -}; -</pre> - -<p>Uma classe que usa esses mix-ins pode ser escrita assim:</p> - -<pre class="brush: js">class Foo { } -class Bar extends calculatorMixin(randomizerMixin(Foo)) { }</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-class-definitions', 'Class definitions')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Definição inicial.</td> - </tr> - <tr> - <td>{{SpecName('ES2016', '#sec-class-definitions', 'Class definitions')}}</td> - <td>{{Spec2('ES2016')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES2017', '#sec-class-definitions', 'Class definitions')}}</td> - <td>{{Spec2('ES2017')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-class-definitions', 'Class definitions')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_no_Browser">Compatibilidade no Browser </h2> - -<div class="hidden">A tabela de compatibilidade nesta página é gerada a partir de dados estruturados. Se você quiser contribuir com os dados, consulte: <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> e envie-nos um pull request.</div> - -<p>{{Compat("javascript.classes")}}</p> - -<h2 id="Executar_no_Scratchpad">Executar no Scratchpad</h2> - -<p>Uma classe não pode ser redefinida. Se estiver a escrever código no Scratchpad (Firefox menu Tools > Web Developer > Scratchpad) e se 'executar' a definição de uma classe com o mesmo nome duas vezes, irá receber um obscuro SyntaxError: redeclaration of let <class-name>.</p> - -<p>Para voltar a executar uma definição, utilise o menu Scratchpad's Execute > Reload and Run.<br> - Vote, por favor, no bug <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1428672">#1428672</a>.</p> - -<h2 id="Veja_também">Veja também</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions">Functions</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Statements/class"><code>class</code> declaration</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Operators/class"><code>class</code> expression</a></li> - <li>{{jsxref("Operators/super", "super")}}</li> - <li><a href="https://hacks.mozilla.org/2015/07/es6-in-depth-classes/">Blog post: "ES6 In Depth: Classes"</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/classes/static/index.html b/files/pt-pt/web/javascript/reference/classes/static/index.html deleted file mode 100644 index 9cb5c48367..0000000000 --- a/files/pt-pt/web/javascript/reference/classes/static/index.html +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: static -slug: Web/JavaScript/Reference/Classes/static -translation_of: Web/JavaScript/Reference/Classes/static ---- -<div>{{jsSidebar("Classes")}}</div> - -<p>A palavra-chave <code><strong>static</strong></code> define um método estático para uma classe.</p> - -<div>{{EmbedInteractiveExample("pages/js/classes-static.html")}}</div> - - - -<h2 id="Síntaxe">Síntaxe</h2> - -<pre class="syntaxbox">static <em>nomeDoMetodo</em>() { ... }</pre> - -<h2 id="Descrição">Descrição</h2> - -<p>Métodos estáticos são chamados diretamente na classe mas não em instâncias da mesma. Estes são regularmente utilizados para criar funções utilitárias.</p> - -<h2 id="Como_chamar_métodos_estáticos">Como chamar métodos estáticos</h2> - -<h3 id="Noutro_método_estático">Noutro método estático</h3> - -<p>Para chamar um método estático dentro de outro que pertença à mesma classe, pode-se usar a palavra-chave <code><a href="/en-US/docs/Web/JavaScript/Reference/Operators/this">this</a></code>.</p> - -<pre class="brush: js">class StaticMethodCall { - static staticMethod() { - return 'Metodo estatico foi invocado'; - } - static anotherStaticMethod() { - return this.staticMethod() + ' dentro de outro'; - } -} -StaticMethodCall.staticMethod(); -// 'Metodo estatico foi invocado' - -StaticMethodCall.anotherStaticMethod(); -// 'Metodo estatico foi invocado dentro de outro'</pre> - -<h3 id="No_construtor_de_classe_e_noutros_métodos">No construtor de classe e noutros métodos</h3> - -<p>Métodos estáticos não são acessíveis através da palavra-chave <code><a href="/en-US/docs/Web/JavaScript/Reference/Operators/this">this</a></code> quando dentro de métodos não-estáticos. É preciso chamá-los ou através do nome da própria classe: <code>CLASSNAME.STATIC_METHOD_NAME()</code> ou como propriedade do construtor da classe: <code>this.constructor.STATIC_METHOD_NAME()</code>.</p> - -<pre class="brush: js">class StaticMethodCall { - constructor() { - console.log(StaticMethodCall.staticMethod()); - // 'metodo estatico foi invocado.' - - console.log(this.constructor.staticMethod()); - // 'metodo estatico foi invocado.' - } - - static staticMethod() { - return 'metodo estatico foi invocado.'; - } -}</pre> - -<h2 id="Exemplos">Exemplos</h2> - -<p>Os seguintes exemplos demonstram:</p> - -<ol> - <li>Como implementar um método estático numa classe.</li> - <li>Que se podem criar sub-classes a partir de uma classe com um membro estático (e usá-los).</li> - <li>Como se pode chamar um método estático (com contra-exemplos).</li> -</ol> - -<pre class="brush: js">class Triple { - static triple(n) { - if (n === undefined) { - n = 1; - } - return n * 3; - } -} - -class BiggerTriple extends Triple { - static triple(n) { - return super.triple(n) * super.triple(n); - } -} - -console.log(Triple.triple()); // 3 -console.log(Triple.triple(6)); // 18 - -var tp = new Triple(); - -console.log(BiggerTriple.triple(3)); -// 81 (não foi afetado pela instanciação do pai) - -console.log(tp.triple()); -// 'tp.triple is not a function'. (não é função) -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-class-definitions', 'Definições de Classe')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Definição inicial.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-class-definitions', 'Definições de Classe')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_browsers">Compatibilidade de browsers</h2> - - - -<p>{{Compat("javascript.classes.static")}}</p> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Operators/class">expressão <code>class</code></a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Statements/class">declaração <code>class</code></a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Classes">Classes</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/deprecated_and_obsolete_features/index.html b/files/pt-pt/web/javascript/reference/deprecated_and_obsolete_features/index.html deleted file mode 100644 index db64832bf4..0000000000 --- a/files/pt-pt/web/javascript/reference/deprecated_and_obsolete_features/index.html +++ /dev/null @@ -1,290 +0,0 @@ ---- -title: Funcionalidades obsoletas -slug: Web/JavaScript/Reference/Deprecated_and_obsolete_features -tags: - - JavaScript - - Obsoleto -translation_of: Web/JavaScript/Reference/Deprecated_and_obsolete_features -original_slug: Web/JavaScript/Reference/Funcionalidades_obsoletas ---- -<div>{{JsSidebar("More")}}</div> - -<p>Esta página lista as funcionalidades de JavaScript que estão obsoletas (ou seja, ainda disponíveis, mas planeadas para remoção) e obsoletas (isto é, não são mais utilizáveis).</p> - -<h2 id="Funcionalidades_obsoletas">Funcionalidades obsoletas</h2> - -<p>Estas funcionalidades obsoletas ainda podem ser utilziadas, mas devem ser utilizadas com cuidado, pois espera-se que estas sejam removidas inteiramente no futuro. Deverá trabalhar para remover a utilização das mesmas do seu código..</p> - -<h3 id="Propriedades_de_RegExp">Propriedades de RegExp</h3> - -<p>The following properties are deprecated. This does not affect their use in {{jsxref("String.replace", "replacement strings", "", 1)}}:</p> - -<table class="standard-table"> - <tbody> - <tr> - <th>Propriedades</th> - <th>Descrição</th> - </tr> - <tr> - <td>{{jsxref("RegExp.n", "$1-$9")}}</td> - <td> - <p>Parenthesized substring matches, if any.<br> - <strong>Warning:</strong> Using these properties can result in problems, since browser extensions can modify them. Avoid them!</p> - </td> - </tr> - <tr> - <td>{{jsxref("RegExp.input", "$_")}}</td> - <td>See <code>input</code>.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.multiline", "$*")}}</td> - <td>See <code>multiline</code>.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.lastMatch", "$&")}}</td> - <td>See <code>lastMatch</code>.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.lastParen", "$+")}}</td> - <td>See <code>lastParen</code>.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.leftContext", "$`")}}</td> - <td>See <code>leftContext</code>.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.rightContext", "$'")}}</td> - <td>See <code>rightContext</code>.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.input", "input")}}</td> - <td>The string against which a regular expression is matched.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.lastMatch", "lastMatch")}}</td> - <td>The last matched characters.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.lastParen", "lastParen")}}</td> - <td>The last parenthesized substring match, if any.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.leftContext", "leftContext")}}</td> - <td>The substring preceding the most recent match.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.rightContext", "rightContext")}}</td> - <td>The substring following the most recent match.</td> - </tr> - </tbody> -</table> - -<p>The following are now properties of <code>RegExp</code> instances, no longer of the <code>RegExp</code> object:</p> - -<table class="standard-table"> - <tbody> - <tr> - <th>Propriedades</th> - <th>Descrição</th> - </tr> - <tr> - <td>{{jsxref("RegExp.global", "global")}}</td> - <td>Whether or not to test the regular expression against all possible matches in a string, or only against the first.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.ignoreCase", "ignoreCase")}}</td> - <td>Whether or not to ignore case while attempting a match in a string.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.lastIndex", "lastIndex")}}</td> - <td>The index at which to start the next match.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.multiline", "multiline")}}</td> - <td>Whether or not to search in strings across multiple lines.</td> - </tr> - <tr> - <td>{{jsxref("RegExp.source", "source")}}</td> - <td>The text of the pattern.</td> - </tr> - </tbody> -</table> - -<h3 id="Métodos_de_egExp">Métodos de egExp</h3> - -<ul> - <li>The {{jsxref("RegExp.compile", "compile()")}} method is deprecated.</li> - <li>The <code>valueOf</code> method is no longer specialized for <code>RegExp</code>. Use {{jsxref("Object.valueOf()")}}.</li> -</ul> - -<h3 id="Propriedades_de_Function">Propriedades de <em>Function</em></h3> - -<ul> - <li>The {{jsxref("Global_Objects/Function/caller", "caller")}} and {{jsxref("Global_Objects/Function/arguments", "arguments")}} properties are deprecated, because they leak the function caller. Instead of the arguments property, you should use the {{jsxref("Functions/arguments", "arguments")}} object inside function closures.</li> -</ul> - -<h3 id="Gerador_de_Legacy">Gerador de <em>Legacy</em></h3> - -<ul> - <li>{{jsxref("Statements/Legacy_generator_function", "Legacy generator function statement")}} and {{jsxref("Operators/Legacy_generator_function", "Legacy generator function expression")}} are deprecated. Use {{jsxref("Statements/function*", "function* statement")}} and {{jsxref("Operators/function*", "function* expression")}} instead.</li> - <li>{{jsxref("Operators/Array_comprehensions", "JS1.7/JS1.8 Array comprehension", "#Differences_to_the_older_JS1.7.2FJS1.8_comprehensions")}} and {{jsxref("Operators/Generator_comprehensions", "JS1.7/JS1.8 Generator comprehension", "#Differences_to_the_older_JS1.7.2FJS1.8_comprehensions")}} are deprecated.</li> -</ul> - -<h3 id="Iterator"><em>Iterator</em></h3> - -<ul> - <li>{{jsxref("Global_Objects/StopIteration", "StopIteration")}} is deprecated.</li> - <li>{{jsxref("Global_Objects/Iterator", "Iterator")}} is deprecated.</li> -</ul> - -<h3 id="Métodos_de_Object">Métodos de <em>Object</em></h3> - -<ul> - <li>{{jsxref("Object.watch", "watch")}} and {{jsxref("Object.unwatch", "unwatch")}} are deprecated. Use {{jsxref("Proxy")}} instead.</li> - <li><code>__iterator__</code> is deprecated.</li> - <li>{{jsxref("Object.noSuchMethod", "__noSuchMethod__")}} is deprecated. Use {{jsxref("Proxy")}} instead.</li> -</ul> - -<h3 id="Métodos_de_Date">Métodos de <em>Date</em></h3> - -<ul> - <li>{{jsxref("Global_Objects/Date/getYear", "getYear")}} and {{jsxref("Global_Objects/Date/setYear", "setYear")}} are affected by the Year-2000-Problem and have been subsumed by {{jsxref("Global_Objects/Date/getFullYear", "getFullYear")}} and {{jsxref("Global_Objects/Date/setFullYear", "setFullYear")}}.</li> - <li>You should use {{jsxref("Global_Objects/Date/toISOString", "toISOString")}} instead of the deprecated {{jsxref("Global_Objects/Date/toGMTString", "toGMTString")}} method in new code.</li> - <li>{{jsxref("Global_Objects/Date/toLocaleFormat", "toLocaleFormat")}} is deprecated.</li> -</ul> - -<h3 id="Functions"><em>Functions</em></h3> - -<ul> - <li>{{jsxref("Operators/Expression_closures", "Expression closures", "", 1)}} are deprecated. Use regular {{jsxref("Operators/function", "functions")}} or {{jsxref("Functions/Arrow_functions", "arrow functions", "", 1)}} instead.</li> -</ul> - -<h3 id="Proxy"><em>Proxy</em></h3> - -<ul> - <li><a href="/en-US/docs/Archive/Web/Old_Proxy_API">Proxy.create</a> and <a href="/en-US/docs/Archive/Web/Old_Proxy_API">Proxy.createFunction</a> are deprecated. Use {{jsxref("Proxy")}} instead.</li> - <li>The following traps are obsolete: - <ul> - <li><code>hasOwn</code> ({{bug(980565)}}, Firefox 33).</li> - <li><code>getEnumerablePropertyKeys</code> ({{bug(783829)}}, Firefox 37)</li> - <li><code>getOwnPropertyNames</code> ({{bug(1007334)}}, Firefox 33)</li> - <li><code>keys</code> ({{bug(1007334)}}, Firefox 33)</li> - </ul> - </li> -</ul> - -<h3 id="Sequências_de_Escape">Sequências de <em>Escape</em></h3> - -<ul> - <li>Octal escape sequences (\ followed by one, two, or three octal digits) are deprecated in string and regular expression literals.</li> - <li>The {{jsxref("Global_Objects/escape", "escape")}} and {{jsxref("Global_Objects/unescape", "unescape")}} functions are deprecated. Use {{jsxref("Global_Objects/encodeURI", "encodeURI")}}, {{jsxref("Global_Objects/encodeURIComponent", "encodeURIComponent")}}, {{jsxref("Global_Objects/decodeURI", "decodeURI")}} or {{jsxref("Global_Objects/decodeURIComponent", "decodeURIComponent")}} to encode and decode escape sequences for special characters.</li> -</ul> - -<h3 id="Métodos_de_String">Métodos de <em>String</em></h3> - -<ul> - <li><a href="https://developer.mozilla.org/en-US/docs/tag/HTML%20wrapper%20methods">HTML wrapper methods</a> like {{jsxref("String.prototype.fontsize")}} and {{jsxref("String.prototype.big")}}.</li> - <li>{{jsxref("String.prototype.quote")}} is removed from Firefox 37.</li> - <li>non standard <code>flags</code> parameter in {{jsxref("String.prototype.search")}}, {{jsxref("String.prototype.match")}}, and {{jsxref("String.prototype.replace")}} are deprecated.</li> -</ul> - -<h2 id="Funcionalidades_removidas">Funcionalidades removidas</h2> - -<p>Estas funcionalidades obsoletas foram totalmente removidas do JavaScript e não podem mais ser utilizadas a partir da versão indicada do JavaScript.</p> - -<h3 id="Object"><em>Object</em></h3> - -<table class="standard-table"> - <tbody> - <tr> - <th>Property</th> - <th>Description</th> - </tr> - <tr> - <td>{{jsxref("Global_Objects/Object/count", "__count__")}}</td> - <td>Returns the number of enumerable properties directly on a user-defined object.</td> - </tr> - <tr> - <td>{{jsxref("Global_Objects/Object/Parent", "__parent__")}}</td> - <td>Points to an object's context.</td> - </tr> - <tr> - <td>{{jsxref("Global_Objects/Object/eval", "Object.prototype.eval()")}}</td> - <td>Evaluates a string of JavaScript code in the context of the specified object.</td> - </tr> - <tr> - <td>{{jsxref("Object.observe()")}}</td> - <td>Asynchronously observing the changes to an object.</td> - </tr> - <tr> - <td>{{jsxref("Object.unobserve()")}}</td> - <td>Remove observers.</td> - </tr> - <tr> - <td>{{jsxref("Object.getNotifier()")}}</td> - <td>Creates an object that allows to synthetically trigger a change.</td> - </tr> - </tbody> -</table> - -<h3 id="Function"><em>Function</em></h3> - -<table class="standard-table"> - <tbody> - <tr> - <th>Property</th> - <th>Description</th> - </tr> - <tr> - <td>{{jsxref("Global_Objects/Function/arity", "arity")}}</td> - <td>Number of formal arguments.</td> - </tr> - </tbody> -</table> - -<h3 id="Array"><em>Array</em></h3> - -<table class="standard-table"> - <tbody> - <tr> - <td>Property</td> - <td>Description</td> - </tr> - <tr> - <td>{{jsxref("Array.observe()")}}</td> - <td>Asynchronously observing changes to Arrays.</td> - </tr> - <tr> - <td>{{jsxref("Array.unobserve()")}}</td> - <td>Remove observers.</td> - </tr> - </tbody> -</table> - -<h3 id="Number"><em>Number</em></h3> - -<ul> - <li>{{jsxref("Number.toInteger()")}}</li> -</ul> - -<h3 id="ParallelArray"><em>ParallelArray</em></h3> - -<ul> - <li>{{jsxref("ParallelArray")}}</li> -</ul> - -<h3 id="Statements"><em>Statements</em></h3> - -<ul> - <li>{{jsxref("Statements/for_each...in", "for each...in")}} is deprecated. Use {{jsxref("Statements/for...of", "for...of")}} instead.</li> - <li>Destructuring {{jsxref("Statements/for...in", "for...in")}} is deprecated. Use {{jsxref("Statements/for...of", "for...of")}} instead.</li> - <li>let blocks and let expressions are obsolete.</li> -</ul> - -<h3 id="E4X">E4X</h3> - -<p>See <a href="/en-US/docs/Archive/Web/E4X">E4X</a> for more information.</p> - -<h3 id="Variáveis_Sharp">Variáveis <em>Sharp</em></h3> - -<p>Consulte <a href="/en-US/docs/Archive/Web/Sharp_variables_in_JavaScript">Sharp variables in JavaScript</a> para mais informação.</p> diff --git a/files/pt-pt/web/javascript/reference/errors/index.html b/files/pt-pt/web/javascript/reference/errors/index.html deleted file mode 100644 index c295fccea6..0000000000 --- a/files/pt-pt/web/javascript/reference/errors/index.html +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: JavaScript error reference -slug: Web/JavaScript/Reference/Errors -tags: - - Debugging - - Error - - Errors - - Exception - - JavaScript - - NeedsTranslation - - TopicStub - - exceptions -translation_of: Web/JavaScript/Reference/Errors ---- -<p>{{jsSidebar("Errors")}}</p> - -<p>Below, you'll find a list of errors which are thrown by JavaScript. These errors can be a helpful debugging aid, but the reported problem isn't always immediately clear. The pages below will provide additional details about these errors. Each error is an object based upon the {{jsxref("Error")}} object, and has a <code>name</code> and a <code>message</code>.</p> - -<p>Errors displayed in the Web console may include a link to the corresponding page below to help you quickly comprehend the problem in your code.</p> - -<h2 id="List_of_errors">List of errors</h2> - -<p>In this list, each page is listed by name (the type of error) and message (a more detailed human-readable error message). Together, these two properties provide a starting point toward understanding and resolving the error. For more information, follow the links below!</p> - -<p>{{ListSubPages("/en-US/docs/Web/JavaScript/Reference/Errors")}}</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Learn/JavaScript/First_steps/What_went_wrong">What went wrong? Troubleshooting JavaScript</a>: Beginner's introductory tutorial on fixing JavaScript errors.</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/errors/not_a_function/index.html b/files/pt-pt/web/javascript/reference/errors/not_a_function/index.html deleted file mode 100644 index e17857e074..0000000000 --- a/files/pt-pt/web/javascript/reference/errors/not_a_function/index.html +++ /dev/null @@ -1,172 +0,0 @@ ---- -title: 'TypeError: "x" is not a function' -slug: Web/JavaScript/Reference/Errors/Not_a_function -tags: - - Erro - - Erros - - JavaScript - - TypeError -translation_of: Web/JavaScript/Reference/Errors/Not_a_function ---- -<div>{{jsSidebar("Errors")}}</div> - -<p>A exeção de JavaScript "is not a function" ocorre quando há uma tentativa de chamar um valor a partir de uma função, mas o valor não é uma função.</p> - -<h2 id="Mensagem">Mensagem</h2> - -<pre class="syntaxbox notranslate">TypeError: Object doesn't support property or method {x} (Edge) -TypeError: "x" is not a function -</pre> - -<h2 id="Tipo_de_erro">Tipo de erro</h2> - -<p>{{jsxref("TypeError")}}</p> - -<h2 id="O_que_deu_errado">O que deu errado?</h2> - -<p>Tentou chamar um valor a partir de uma função, mas o valor não é uma função. Isto acontece quando algum código espera que se forneça uma função, mas isso não acontece.</p> - -<p>Talvez haja um erro no nome da função? Pode ser que o objeto a que está a chamar o método não tenha esta função? Por exemplo, um <code>Object</code> não tem função de <code>map</code>, mas o <code>Array</code> tem.</p> - -<p>Há muitas funções que necessitam de uma função como parâmetro (<em>callback</em>). Terá de fornecer uma função para que estes métodos funcionem corretamente:</p> - -<ul> - <li>Quando se trabalha com objetos {{jsxref("Array")}} ou {{jsxref("TypedArray")}}: - <ul> - <li>{{jsxref("Array.prototype.every()")}}, {{jsxref("Array.prototype.some()")}}, {{jsxref("Array.prototype.forEach()")}}, {{jsxref("Array.prototype.map()")}}, {{jsxref("Array.prototype.filter()")}}, {{jsxref("Array.prototype.reduce()")}}, {{jsxref("Array.prototype.reduceRight()")}}, {{jsxref("Array.prototype.find()")}}</li> - </ul> - </li> - <li>Quando se trabalha com objetos {{jsxref("Map")}} e {{jsxref("Set")}}: - <ul> - <li>{{jsxref("Map.prototype.forEach()")}} e {{jsxref("Set.prototype.forEach()")}}</li> - </ul> - </li> -</ul> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Um_erro_no_nome_da_função">Um erro no nome da função</h3> - -<p>Neste caso existe um erro no nome função:</p> - -<pre class="brush: js example-bad notranslate">let x = document.getElementByID('foo'); -// TypeError: document.getElementByID is not a function -</pre> - -<p>O nome correto da função é <code>getElementByI<strong>d</strong></code>:</p> - -<pre class="brush: js example-good notranslate">let x = document.getElementById('foo'); -</pre> - -<h3 id="Função_é_chamada_no_objeto_errado">Função é chamada no objeto errado</h3> - -<p>Para certos métodos, é necessário fornecer uma função (<em>callback</em>) e funcionará apenas em objetos específicos. Neste exemplo, é utilizado o {{jsxref("Array.prototype.map()")}}, que funcionará apenas com objetos {{jsxref("Array")}}.</p> - -<pre class="brush: js example-bad notranslate">let obj = {a: 13, b: 37, c: 42}; - -obj.map(function(num) { - return num * 2; -}); - -// TypeError: obj.map is not a function</pre> - -<p>Use antes uma matriz:</p> - -<pre class="brush: js example-good notranslate">let numbers = [1, 4, 9]; - -numbers.map(function(num) { - return num * 2; -}); - -// Array [2, 8, 18] -</pre> - -<h3 id="Function_shares_a_name_with_a_pre-existing_property">Function shares a name with a pre-existing property</h3> - -<p>Por vezes, ao criar uma classe, pode ter uma propriedade e uma função com o mesmo nome. Ao chamar a função, o compilador pensa que a função deixa de existir.</p> - -<pre class="brush: js example-bad notranslate">var Dog = function () { - this.age = 11; - this.color = "black"; - this.name = "Ralph"; - return this; -} - -Dog.prototype.name = function(name) { - this.name = name; - return this; -} - - -var myNewDog = new Dog(); -myNewDog.name("Cassidy"); //Uncaught TypeError: myNewDog.name is not a function -</pre> - -<p>Use um nome diferente para a propriedade:</p> - -<pre class="brush: js example-good notranslate">var Dog = function () { - this.age = 11; - this.color = "black"; - this.dogName = "Ralph"; //Using this.dogName instead of .name - return this; -} - -Dog.prototype.name = function(name) { - this.dogName = name; - return this; -} - - -var myNewDog = new Dog(); -myNewDog.name("Cassidy"); //Dog { age: 11, color: 'black', dogName: 'Cassidy' } -</pre> - -<h3 id="Usar_parênteses_para_multiplicação">Usar parênteses para multiplicação</h3> - -<p>Em matemática, pode escrever 2 × (3 + 5) como 2*(3 + 5) ou somente 2(3 + 5).</p> - -<p>Usar a última forma dá um erro:</p> - -<pre class="js example-bad notranslate">const sixteen = 2(3 + 5); -alert('2 x (3 + 5) is ' + String(sixteen)); -//Uncaught TypeError: 2 is not a function</pre> - -<p>Pode corrigir o erro com a operadora <code>*</code>:</p> - -<pre class="js example-good notranslate">const sixteen = 2 * (3 + 5); -alert('2 x (3 + 5) is ' + String(sixteen)); -//2 x (3 + 5) is 16 -</pre> - -<h3 id="Importar_o_modulo_exportado_corretamente">Importar o modulo exportado corretamente</h3> - -<p>Certifique-se que está a importar o módulo corretamente.</p> - -<p>Um exemplo de uma biblioteca <em>helper</em> (<code>helpers.js</code>)</p> - -<pre class="brush: js notranslate">let helpers = function () { }; - -helpers.groupBy = function (objectArray, property) { - return objectArray.reduce(function (acc, obj) { - var key = obj[property]; - if (!acc[key]) { - acc[key] = []; - } - acc[key].push(obj); - return acc; - }, -{}); -} - -export default helpers; -</pre> - -<p>A utilização correta de importação (para <code>App.js</code>) é:</p> - -<pre class="notranslate">import helpers from './helpers'</pre> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li><a href="/pt-PT/docs/Web/JavaScript/Reference/Funcoes">Funções</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/errors/stmt_after_return/index.html b/files/pt-pt/web/javascript/reference/errors/stmt_after_return/index.html deleted file mode 100644 index f3d1de92c8..0000000000 --- a/files/pt-pt/web/javascript/reference/errors/stmt_after_return/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: 'Aviso: código inacessível depois de declaração de retorno' -slug: Web/JavaScript/Reference/Errors/Stmt_after_return -tags: - - Aviso - - JavaScript -translation_of: Web/JavaScript/Reference/Errors/Stmt_after_return ---- -<div>{{jsSidebar("Errors")}}</div> - -<h2 id="Mensagem">Mensagem</h2> - -<pre class="syntaxbox">Warning: unreachable code after return statement (Firefox) -</pre> - -<h2 id="Tipo_de_ErroEdit">Tipo de Erro<a class="button section-edit only-icon" href="https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Errors/Stmt_after_return$edit#Tipo_de_Erro" rel="nofollow, noindex"><span>Edit</span></a></h2> - -<p>Aviso</p> - -<h2 id="O_que_correu_malEdit">O que correu mal?<a class="button section-edit only-icon" href="https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Errors/Stmt_after_return$edit#O_que_deu_errado" rel="nofollow, noindex"><span>Edit</span></a></h2> - -<p><em>Unreachable code after return statement</em> pode ocorrer nas seguintes situações:</p> - -<ul> - <li>Quando é utilizada uma expressão depois de uma declaração <a href="/pt-PT/docs/Web/JavaScript/Reference/Extratos_e_declarações/return" title="A declaração return finaliza a execução de uma função e especifica os valores que devem ser retonados para onde a função foi chamada."><code>return</code></a> , ou</li> - <li>quando é utilizada uma declaração <em>return</em> sem ponto e vírgula, mas incluindo uma declaração diretamente depois.</li> -</ul> - -<p>Quando existe uma expressão depois de uma declaração <code>return</code> válida, é dado um aviso para indicar que o código depois da declaração <code>return</code> é inacessível, o que significa que o mesmo nunca pode ser executado.</p> - -<p>Porquê é que eu deveria ter ponto e vírgula depois de declarações <code>return</code>? No caso de declarações <code>return</code> sem ponto e vírgula, não é claro se o programador pretendia devolver a declaração na linha seguinte, ou para parar a execução e o retorno. O aviso indica que existe ambiguidade no modo como a declaração <code>return</code> foi escrita.</p> - -<p>Os avisos não serão apresentados para declarações <em>return</em> sem ponto-e-vírgula nas seguintes situações:</p> - -<ul> - <li>{{jsxref("Statements/throw", "throw")}}</li> - <li>{{jsxref("Statements/break", "break")}}</li> - <li>{{jsxref("Statements/var", "var")}}</li> - <li>{{jsxref("Statements/function", "function")}}</li> -</ul> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Casos_inválidos">Casos inválidos</h3> - -<pre class="brush: js example-bad">function f() { - var x = 3; - x += 4; - return x; // retorna a função de imediato - x -= 3; // logo, esta linha não será executada; é inacessivel -} - -function f() { - return // é tratado como um `return;` - 3 + 4; // logo, a função é retornada, porém esta linha não será alcançada -} -</pre> - -<h3 id="Casos_válidos">Casos válidos</h3> - -<pre class="brush: js example-good">function f() { - var x = 3; - x += 4; - x -= 3; - return x; // OK: return depois de todas as declarações -} - -function f() { - return 3 + 4 // OK: um return sem ponto e vírgula com uma expressão na mesma linha -} -</pre> - -<h2 id="Consulte_tambémEdit">Consulte também<a class="button section-edit only-icon" href="https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Errors/Stmt_after_return$edit#Ver_também" rel="nofollow, noindex"><span>Edit</span></a></h2> - -<ul> - <li>{{jsxref("Statements/return", "Automatic Semicolon Insertion", "#Automatic_Semicolon_Insertion", 1)}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/errors/unexpected_token/index.html b/files/pt-pt/web/javascript/reference/errors/unexpected_token/index.html deleted file mode 100644 index 55103f82a7..0000000000 --- a/files/pt-pt/web/javascript/reference/errors/unexpected_token/index.html +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: 'SyntaxError: Unexpected token' -slug: Web/JavaScript/Reference/Errors/Unexpected_token -tags: - - Erro de Sintaxe - - Erros - - JavaScript -translation_of: Web/JavaScript/Reference/Errors/Unexpected_token ---- -<div>{{jsSidebar("Errors")}}</div> - -<h2 id="Mensagem">Mensagem</h2> - -<pre class="syntaxbox">SyntaxError: expected expression, got "x" -SyntaxError: expected property name, got "x" -SyntaxError: expected target, got "x" -SyntaxError: expected rest argument name, got "x" -SyntaxError: expected closing parenthesis, got "x" -SyntaxError: expected '=>' after argument list, got "x" -</pre> - -<h2 id="Tipo_de_erro">Tipo de erro</h2> - -<p>{{jsxref("SyntaxError")}}</p> - -<h2 id="O_que_aconteceu_de_errado">O que aconteceu de errado?</h2> - -<p>É esperado um contrutor de linguagem específico, mas foi entregue outra coisa qualquer. Isto poderá ser simplesmente um erro de escrita.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Expressão_esperada">Expressão esperada</h3> - -<p>Por exemplo, quando são chamadas funções, as vírgulas imediatamente antes de fechar a função não são permitidas. JavaScript vai esperar outro argumento, que pode na verdade ser qualquer expressão.</p> - -<pre class="brush: js example-bad">Math.max(2, 42,); -// SyntaxError: expected expression, got ')' -</pre> - -<p>Para corrigir o problema, retirava-se a virgula ou adicionavam-se mais argumentos:</p> - -<pre class="brush: js example-good">Math.max(2, 42); -Math.max(2, 42, 13 + 37); -</pre> - -<h2 id="Veja_também">Veja também</h2> - -<ul> - <li>{{jsxref("Math.max()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/errors/unnamed_function_statement/index.html b/files/pt-pt/web/javascript/reference/errors/unnamed_function_statement/index.html deleted file mode 100644 index 25a542b9df..0000000000 --- a/files/pt-pt/web/javascript/reference/errors/unnamed_function_statement/index.html +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: 'Erro de sintaxe: declaração de função precisa de um nome' -slug: Web/JavaScript/Reference/Errors/Unnamed_function_statement -translation_of: Web/JavaScript/Reference/Errors/Unnamed_function_statement -original_slug: Web/JavaScript/Reference/Errors/declaração_função_sem_nome ---- -<div>{{jsSidebar("Errors")}}</div> - -<h2 id="Mensagem">Mensagem</h2> - -<pre class="syntaxbox">Syntax Error: Expected identifier (Edge) -SyntaxError: function statement requires a name [Firefox] -SyntaxError: Unexpected token ( [Chrome] -</pre> - -<h2 id="Tipo_de_erro">Tipo de erro</h2> - -<p>{{jsxref("SyntaxError")}}</p> - -<h2 id="O_que_correu_mal">O que correu mal?</h2> - -<p>Existe uma <a href="/en-US/docs/Web/JavaScript/Reference/Statements/function">declaração de função</a> no código que precisa de um nome. Você deve verficiar como as funções são definidas e se é necessário indicar um nome para a função</p> - -<p><span class="tlid-translation translation"><span title="">Existe uma </span></span><a href="/en-US/docs/Web/JavaScript/Reference/Statements/function">declaração de função</a><span class="tlid-translation translation"><span title=""> no código que requer um nome.</span> <span title="">Você precisará verificar como as funções são definidas e se você precisa fornecer um nome para a função, ou se a função em questão precisa ser uma expressão de função, um {{Glossary ("IIFE")}}, ou se o</span> <span title="">código da função esta colocado corretamente neste contexto.</span></span></p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Declarações_vs_Expressões">Declarações vs Expressões</h3> - -<p>Uma <em><a href="/en-US/docs/Web/JavaScript/Reference/Statements/function">declaração de função</a></em> precisa de um nome, o código seguinte não funciona:</p> - -<pre class="brush: js example-bad">function () { - return 'Hello world'; -} -// SyntaxError: function statement requires a name -</pre> - -<p>É possível usar uma <a href="/en-US/docs/Web/JavaScript/Reference/Operators/function">expressão de função</a> (atribuição) como alternativa:</p> - -<pre class="brush: js example-good">var greet = function() { - return 'Hello world'; -};</pre> - -<p><span class="tlid-translation translation"><span title="">Ou, a sua função é talvez destinada a ser uma IIFE (Expressão de Função Invocada Imediatamente), que é uma função que é executada assim que é definida.</span> Serão precisos<span title=""> mais alguns parêntises neste caso:</span></span></p> - -<pre class="brush: js example-good">(function () { - -})();</pre> - -<h3 id="Funções_com_nome">Funções com nome</h3> - -<p>Se você está a usar uma função com <a href="/en-US/docs/Web/JavaScript/Reference/Statements/label">identificador</a>, <span class="tlid-translation translation"><span title="">ainda precisará fornecer um nome de função após a palavra-chave da função.</span> O código seguinte<span title=""> não funciona:</span></span></p> - -<pre class="brush: js example-bad">function Greeter() { - german: function () { - return "Moin"; - } -} -// SyntaxError: function statement requires a name -</pre> - -<p>O código seguinte irá funcionar por exemplo:</p> - -<pre class="brush: js example-good">function Greeter() { - german: function g() { - return "Moin"; - } -}</pre> - -<h3 id="Métodos_de_objectos">Métodos de objectos</h3> - -<p><span class="tlid-translation translation"><span title="">Se você pretendia criar um método de um objeto, você precisará criar um objeto.</span> <span title="">A sintaxe a seguir sem um nome após a palavra-chave </span></span><code>function</code><span class="tlid-translation translation"><span title=""> é válida.</span></span></p> - -<pre class="brush: js example-good">var greeter = { - german: function () { - return "Moin"; - } -};</pre> - -<h3 id="Sintaxe_de_Callback">Sintaxe de Callback</h3> - -<p>Além disso, verifique a sintaxe ao usar callbacks. Parêntisis e virgurlas podem facilmente se tornar complicados.</p> - -<pre class="brush: js example-bad">promise.then( - function() { - console.log("success"); - }); - function() { - console.log("error"); -} -// SyntaxError: function statement requires a name -</pre> - -<p>:</p> - -<pre class="brush: json example-good">promise.then( - function() { - console.log("success"); - }, - function() { - console.log("error"); - } -); -</pre> - -<h2 id="Veja_também">Veja também</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Guide/Functions">Functions in the JavaScript Guide</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Statements/function">function statement</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Operators/function">function expression</a></li> - <li><a href="https://en.wikipedia.org/wiki/Immediately-invoked_function_expression">IIFE</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Statements/label">label</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/functions/arguments/index.html b/files/pt-pt/web/javascript/reference/functions/arguments/index.html deleted file mode 100644 index 01c656de88..0000000000 --- a/files/pt-pt/web/javascript/reference/functions/arguments/index.html +++ /dev/null @@ -1,229 +0,0 @@ ---- -title: O objeto arguments -slug: Web/JavaScript/Reference/Functions/arguments -tags: - - Class - - Funções - - JavaScript - - Referencia - - arguments -translation_of: Web/JavaScript/Reference/Functions/arguments -original_slug: Web/JavaScript/Reference/Funcoes/arguments ---- -<p>{{JSSidebar("Functions")}}</p> - -<p><strong><code>arguments</code></strong> é um objeto semelhante a uma "<code>Matiz</code>" acessível dentro de <em>functions </em>que contém os valores dos argumentos passados para essa função.</p> - -<div class="blockIndicator note"> -<p><strong>Nota:</strong> If you're writing ES6 compatible code, then <a href="/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters">rest parameters</a> should be preferred.</p> -</div> - -<div class="blockIndicator note"> -<p><strong>Nota:</strong> “Array-like” means that <code>arguments</code> has a <code><a href="/en-US/docs/Web/JavaScript/Reference/Functions/arguments/length">length</a></code> property and properties indexed from zero, but it doesn't have {{JSxRef("Array")}}'s built-in methods like <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach">forEach</a></code> and <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map">map</a></code>. See <a href="#Description">§Description</a> for details.</p> -</div> - -<div>{{EmbedInteractiveExample("pages/js/functions-arguments.html")}}</div> - - - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox">arguments</pre> - -<h2 id="Descrição">Descrição</h2> - -<p>The <code>arguments</code> object is a local variable available within all non-<a href="/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions">arrow</a> functions. You can refer to a function's arguments inside that function by using its <code>arguments</code> object. It has entries for each argument the function was called with, with the first entry's index at 0.</p> - -<p>For example, if a function is passed 3 arguments, you can access them as follows:</p> - -<pre class="brush: js">arguments[0] // first argument -arguments[1] // second argument -arguments[2] // third argument -</pre> - -<p>Each argument can also be set or reassigned:</p> - -<pre class="brush: js">arguments[1] = 'new value'; -</pre> - -<p>The <code>arguments</code> object is not an {{JSxRef("Array")}}. It is similar, but does not have any <code>Array</code> properties except <code><a href="/en-US/docs/Web/JavaScript/Reference/Functions/arguments/length">length</a></code>. For example, it does not have the <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/pop">pop</a></code> method. However, it can be converted to a real <code>Array</code>:</p> - -<pre class="brush: js">var args = Array.prototype.slice.call(arguments); -// Using an array literal is shorter than above but allocates an empty array -var args = [].slice.call(arguments); -</pre> - -<p>As you can do with any Array-like object, you can use ES2015's {{JSxRef("Array.from()")}} method or <a href="/en-US/docs/Web/JavaScript/Reference/Operators/Spread_operator">spread operator</a> to convert <code>arguments</code> to a real Array:</p> - -<pre>let args = Array.from(arguments); -// or -let args = [...arguments];</pre> - -<p>The <code>arguments</code> object is useful for functions called with more arguments than they are formally declared to accept. This technique is useful for functions that can be passed a variable number of arguments, such as <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/min">Math.min()</a></code>. This example function accepts any number of string arguments and returns the longest one:</p> - -<pre class="brush: js">function longestString() { - var longest = ''; - for (var i=0; i < arguments.length; i++) { - if (arguments[i].length > longest.length) { - longest = arguments[i]; - } - } - return longest; -} -</pre> - -<p>You can use <code><a href="/en-US/docs/JavaScript/Reference/Functions_and_function_scope/arguments/length">arguments.length</a></code> to count how many arguments the function was called with. If you instead want to count how many parameters a function is declared to accept, inspect that function's <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Function/length">length</a></code> property.</p> - -<h3 id="Utilizar_typeof_com_Arguments">Utilizar <code>typeof</code> com <em>Arguments</em></h3> - -<p>The <code><a href="/en-US/docs/Web/JavaScript/Reference/Operators/typeof">typeof</a></code> operator returns <code>'object'</code> when used with <code>arguments</code></p> - -<pre class="brush: js">console.log(typeof arguments); // 'object' </pre> - -<p>The type of individual arguments can be determined by indexing <code>arguments</code>:</p> - -<pre>console.log(typeof arguments[0]); // returns the type of the first argument</pre> - -<h2 id="Propriedades">Propriedades</h2> - -<dl> - <dt></dt> - <dt>{{jsxref("Functions/arguments/callee", "arguments.callee")}}</dt> - <dd>Reference to the currently executing function that the arguments belong to.</dd> - <dt>{{jsxref("Functions/arguments/length", "arguments.length")}}</dt> - <dd>The number of arguments that were passed to the function.</dd> - <dt>{{jsxref("Functions/arguments/@@iterator", "arguments[@@iterator]")}}</dt> - <dd>Returns a new {{jsxref("Array/@@iterator", "Array iterator", "", 0)}} object that contains the values for each index in <code>arguments</code>.</dd> -</dl> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Definir_uma_function_que_concatena_várias_strings">Definir uma <em>function</em> que concatena várias <em>strings</em></h3> - -<p>This example defines a function that concatenates several strings. The function's only formal argument is a string containing the characters that separate the items to concatenate.</p> - -<pre class="brush:js">function myConcat(separator) { - var args = Array.prototype.slice.call(arguments, 1); - return args.join(separator); -}</pre> - -<p>You can pass as many arguments as you like to this function. It returns a string list using each argument in the list:</p> - -<pre class="brush:js">// returns "red, orange, blue" -myConcat(', ', 'red', 'orange', 'blue'); - -// returns "elephant; giraffe; lion; cheetah" -myConcat('; ', 'elephant', 'giraffe', 'lion', 'cheetah'); - -// returns "sage. basil. oregano. pepper. parsley" -myConcat('. ', 'sage', 'basil', 'oregano', 'pepper', 'parsley');</pre> - -<h3 id="Definir_uma_function_que_cria_listas_HTML">Definir uma <em>function</em> que cria listas HTML</h3> - -<p>This example defines a function that creates a string containing HTML for a list. The only formal argument for the function is a string that is "<code>u</code>" if the list is to be unordered (bulleted), or "<code>o</code>" if the list is to be ordered (numbered). The function is defined as follows:</p> - -<pre class="brush:js">function list(type) { - var html = '<' + type + 'l><li>'; - var args = Array.prototype.slice.call(arguments, 1); - html += args.join('</li><li>'); - html += '</li></' + type + 'l>'; // end list - - return html; -}</pre> - -<p>You can pass any number of arguments to this function, and it adds each argument as a list item to a list of the type indicated. For example:</p> - -<pre class="brush:js">var listHTML = list('u', 'One', 'Two', 'Three'); - -/* listHTML is: -"<ul><li>One</li><li>Two</li><li>Three</li></ul>" -*/</pre> - -<h3 id="Parâmetros_Rest_predefinição_e_desestruturados">Parâmetros Rest, predefinição, e desestruturados</h3> - -<p>The <code>arguments</code> object can be used in conjunction with <a href="/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters">rest</a>, <a href="/en-US/docs/Web/JavaScript/Reference/Functions/Default_parameters">default</a>, and <a href="/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment">destructured</a> parameters.</p> - -<pre class="brush: js">function foo(...args) { - return args; -} -foo(1, 2, 3); // [1,2,3] -</pre> - -<p>While the presence of rest, default, or destructured parameters does not alter the <a href="/en-US/docs/Web/JavaScript/Reference/Strict_mode#Making_eval_and_arguments_simpler">behavior of the <code>arguments</code> object in strict mode code</a>, there is a subtle difference for non-strict code.</p> - -<p>In strict-mode code, the <code>arguments</code> object behaves the same whether or not a function is passed rest, default, or destructured parameters. That is, assigning new values to variables in the body of the function will not affect the <code>arguments</code> object. Nor will assigning new variables to the <code>arguments</code> object affect the value of variables.</p> - -<div class="blockIndicator note"> -<p><strong>Nota:</strong> You cannot write a <code>"use strict";</code> directive in the body of a function definition that accepts rest, default, or destructured parameters. Doing so will throw <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Errors/Strict_Non_Simple_Params">a syntax error</a>.</p> -</div> - -<p>Non-strict functions that are passed only simple parameters (that is, not rest, default, or restructured parameters) will sync the value of variables new values in the body of the function with the <code>arguments</code> object, and vice versa:</p> - -<pre class="brush: js">function func(a) { - arguments[0] = 99; // updating arguments[0] also updates a - console.log(a); -} -func(10); // 99 -</pre> - -<p>And also:</p> - -<pre class="brush: js">function func(a) { - a = 99; // updating a also updates arguments[0] - console.log(arguments[0]); -} -func(10); // 99 -</pre> - -<p>Conversely, non-strict functions that <strong>are</strong> passed rest, default, or destructured parameters <strong>will not</strong> sync new values assigned to argument variables in the function body with the <code>arguments</code> object. Instead, the <code>arguments</code> object in non-strict functions with complex parameters <strong>will always</strong> reflect the values passed to the function when the function was called (this is the same behavior as exhibited by all strict-mode functions, regardless of the type of variables they are passed):</p> - -<pre class="brush: js">function func(a = 55) { - arguments[0] = 99; // updating arguments[0] does not also update a - console.log(a); -} -func(10); // 10</pre> - -<p>E também:</p> - -<pre class="brush: js">function func(a = 55) { - a = 99; // updating a does not also update arguments[0] - console.log(arguments[0]); -} -func(10); // 10 -</pre> - -<p>E também:</p> - -<pre class="brush: js">// An untracked default parameter -function func(a = 55) { - console.log(arguments[0]); -} -func(); // undefined</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-arguments-exotic-objects', 'Arguments Exotic Objects')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibildiade_de_navegador">Compatibildiade de navegador</h2> - - - -<p>{{Compat("javascript.functions.arguments")}}</p> - -<h2 id="Consulte_também">Consulte também</h2> - -<ul> - <li>{{JSxRef("Function")}}</li> - <li><a href="/pt-PT/docs/Web/JavaScript/Reference/Funcoes/parametros_rest">Parâmetros Rest</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/functions/arrow_functions/index.html b/files/pt-pt/web/javascript/reference/functions/arrow_functions/index.html deleted file mode 100644 index 1a2246534b..0000000000 --- a/files/pt-pt/web/javascript/reference/functions/arrow_functions/index.html +++ /dev/null @@ -1,400 +0,0 @@ ---- -title: Expressões da função "Seta" -slug: Web/JavaScript/Reference/Functions/Arrow_functions -translation_of: Web/JavaScript/Reference/Functions/Arrow_functions -original_slug: Web/JavaScript/Reference/Funcoes/Funcoes_seta ---- -<div>{{jsSidebar("Functions")}}</div> - -<p>Uma <strong>expressão da função seta</strong> é uma alternativa sintaticamente compacta a uma expressão de <a href="/pt-PT/docs/Web/JavaScript/Reference/Operadores/função">expressão de função</a> regular, embora sem as suas próprias associações às palavras-chave <code><a href="/en-US/docs/Web/JavaScript/Reference/Operators/this">this</a></code>, <code><a href="/en-US/docs/Web/JavaScript/Reference/Functions/arguments">arguments</a></code>, <code><a href="/en-US/docs/Web/JavaScript/Reference/Operators/super">super</a></code>, ou <code><a href="/en-US/docs/Web/JavaScript/Reference/Operators/new.target">new.target</a></code>. As expressões de função (<em>function</em>) de seta são inadequadas como métodos, e não podem ser utilziadas como construtores.</p> - -<div>{{EmbedInteractiveExample("pages/js/functions-arrow.html")}}</div> - -<h2 id="Sintaxe">Sintaxe</h2> - -<h3 id="Basic_syntax">Basic syntax</h3> - -<pre class="syntaxbox">(param1, param2, …, paramN) => { statements } -(param1, param2, …, paramN) => expression -// equivalent to: => { return expression; } - -// Parentheses are optional when there's only one parameter name: -(singleParam) => { statements } -singleParam => { statements } - -// The parameter list for a function with no parameters should be written with a pair of parentheses. -() => { statements } -</pre> - -<h3 id="Advanced_syntax">Advanced syntax</h3> - -<pre class="syntaxbox">// Parenthesize the body of a function to return an object literal expression: -params => ({foo: bar}) - -// <a href="/en-US/docs/Web/JavaScript/Reference/Functions/Rest_parameters">Rest parameters</a> and <a href="/en-US/docs/Web/JavaScript/Reference/Functions/Default_parameters">default parameters</a> are supported -(param1, param2, ...rest) => { statements } -(param1 = defaultValue1, param2, …, paramN = defaultValueN) => { -statements } - -// <a href="/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment">Destructuring</a> within the parameter list is also supported -var f = ([a, b] = [1, 2], {x: c} = {x: a + b}) => a + b + c; -f(); // 6 -</pre> - -<h2 id="Descrição">Descrição</h2> - -<p>See also <a href="https://hacks.mozilla.org/2015/06/es6-in-depth-arrow-functions/">"ES6 In Depth: Arrow functions" on hacks.mozilla.org</a>.</p> - -<p>Two factors influenced the introduction of arrow functions: the need for shorter functions and the behavior of the <code>this</code> keyword.</p> - -<h3 id="Funções_curtas">Funções curtas</h3> - -<pre class="brush: js">var elements = [ - 'Hydrogen', - 'Helium', - 'Lithium', - 'Beryllium' -]; - -// This statement returns the array: [8, 6, 7, 9] -elements.<a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map">map</a>(function(element) { - return element.length; -}); - -// The regular function above can be written as the arrow function below -elements.map((element) => { - return element.length; -}); // [8, 6, 7, 9] - -// When there is only one parameter, we can remove the surrounding parentheses -elements.<a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map">map</a>(element => { - return element.length; -}); // [8, 6, 7, 9] - -// When the only statement in an arrow function is `return`, we can remove `return` and remove -// the surrounding curly brackets -elements.map(element => element.length); // [8, 6, 7, 9] - -// In this case, because we only need the length property, we can use destructuring parameter: -// Notice that the `length` corresponds to the property we want to get whereas the -// obviously non-special `lengthFooBArX` is just the name of a variable which can be changed -// to any valid variable name you want -elements.<a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map">map</a>(({ length: lengthFooBArX }) => lengthFooBArX); // [8, 6, 7, 9] - -// This destructuring parameter assignment can also be written as seen below. However, note that in -// this example we are not assigning `length` value to the made up property. Instead, the literal name -// itself of the variable `length` is used as the property we want to retrieve from the object. -elements.<a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map">map</a>(({ length }) => length); // [8, 6, 7, 9] -</pre> - -<h3 id="No_separate_this">No separate <code>this</code></h3> - -<p>Before arrow functions, every new function defined its own <code><a href="/en-US/docs/Web/JavaScript/Reference/Operators/this">this</a></code> value based on how the function was called:</p> - -<ul> - <li>A new object in the case of a constructor.</li> - <li><code>undefined</code> in <a href="/en-US/docs/Web/JavaScript/Reference/Strict_mode">strict mode</a> function calls.</li> - <li>The base object if the function was called as an "object method".</li> - <li>etc.</li> -</ul> - -<p>This proved to be less than ideal with an object-oriented style of programming.</p> - -<pre class="brush: js">function Person() { - // The Person() constructor defines `this` as an instance of itself. - this.age = 0; - - setInterval(function growUp() { - // In non-strict mode, the growUp() function defines `this` - // as the global object (because it's where growUp() is executed.), - // which is different from the `this` - // defined by the Person() constructor. - this.age++; - }, 1000); -} - -var p = new Person();</pre> - -<p>In ECMAScript 3/5, the <code>this</code> issue was fixable by assigning the value in <code>this</code> to a variable that could be closed over.</p> - -<pre class="brush: js">function Person() { - var that = this; - that.age = 0; - - setInterval(function growUp() { - // The callback refers to the `that` variable of which - // the value is the expected object. - that.age++; - }, 1000); -}</pre> - -<p>Alternatively, a <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/bind">bound function</a> could be created so that a preassigned <code>this</code> value would be passed to the bound target function (the <code>growUp()</code> function in the example above).</p> - -<p>An arrow function does not have its own <code>this</code>. The <code>this</code> value of the enclosing lexical scope is used; arrow functions follow the normal variable lookup rules. So while searching for <code>this</code> which is not present in current scope, an arrow function ends up finding the <code>this</code> from its enclosing scope.</p> - -<p>Thus, in the following code, the <code>this</code> within the function that is passed to <code>setInterval</code> has the same value as the <code>this</code> in the lexically enclosing function:</p> - -<pre class="brush: js">function Person(){ - this.age = 0; - - setInterval(() => { - this.age++; // |this| properly refers to the Person object - }, 1000); -} - -var p = new Person();</pre> - -<h4 id="Relation_with_strict_mode">Relation with strict mode</h4> - -<p>Given that <code>this</code> comes from the surrounding lexical context, <a href="/en-US/docs/Web/JavaScript/Reference/Strict_mode">strict mode</a> rules with regard to <code>this</code> are ignored.</p> - -<pre class="brush: js">var f = () => { 'use strict'; return this; }; -f() === window; // or the global object</pre> - -<p>All other strict mode rules apply normally.</p> - -<h4 id="Invoked_through_call_or_apply">Invoked through call or apply</h4> - -<p>Since arrow functions do not have their own <code>this</code>, the methods <code>call()</code> and <code>apply()</code> can only pass in parameters. Any <code>this</code> argument is ignored.</p> - -<pre class="brush: js">var adder = { - base: 1, - - add: function(a) { - var f = v => v + this.base; - return f(a); - }, - - addThruCall: function(a) { - var f = v => v + this.base; - var b = { - base: 2 - }; - - return f.call(b, a); - } -}; - -console.log(adder.add(1)); // This would log 2 -console.log(adder.addThruCall(1)); // This would log 2 still</pre> - -<h3 id="No_binding_of_arguments">No binding of <code>arguments</code></h3> - -<p>Arrow functions do not have their own <a href="/en-US/docs/Web/JavaScript/Reference/Functions/arguments"><code>arguments</code> object</a>. Thus, in this example, <code>arguments</code> is simply a reference to the arguments of the enclosing scope:</p> - -<pre class="brush: js">var arguments = [1, 2, 3]; -var arr = () => arguments[0]; - -arr(); // 1 - -function foo(n) { - var f = () => arguments[0] + n; // <em>foo</em>'s implicit arguments binding. arguments[0] is n - return f(); -} - -foo(3); // 6</pre> - -<p>In most cases, using <a href="/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters">rest parameters</a> is a good alternative to using an <code>arguments</code> object.</p> - -<pre class="brush: js">function foo(n) { - var f = (...args) => args[0] + n; - return f(10); -} - -foo(1); // 11</pre> - -<h3 id="Arrow_functions_used_as_methods">Arrow functions used as methods</h3> - -<p>As stated previously, arrow function expressions are best suited for non-method functions. Let's see what happens when we try to use them as methods:</p> - -<pre class="brush: js">'use strict'; - -var obj = { // does not create a new scope - i: 10, - b: () => console.log(this.i, this), - c: function() { - console.log(this.i, this); - } -} - -obj.b(); // prints undefined, Window {...} (or the global object) -obj.c(); // prints 10, Object {...}</pre> - -<p>Arrow functions do not have their own <code>this</code>. Another example involving {{jsxref("Object.defineProperty()")}}:</p> - -<pre class="brush: js">'use strict'; - -var obj = { - a: 10 -}; - -Object.defineProperty(obj, 'b', { - get: () => { - console.log(this.a, typeof this.a, this); // undefined 'undefined' Window {...} (or the global object) - return this.a + 10; // represents global object 'Window', therefore 'this.a' returns 'undefined' - } -}); -</pre> - -<h3 id="Use_of_the_new_operator">Use of the <code>new</code> operator</h3> - -<p>Arrow functions cannot be used as constructors and will throw an error when used with <code>new</code>.</p> - -<pre class="brush: js">var Foo = () => {}; -var foo = new Foo(); // TypeError: Foo is not a constructor</pre> - -<h3 id="Use_of_prototype_property">Use of <code>prototype</code> property</h3> - -<p>Arrow functions do not have a <code>prototype</code> property.</p> - -<pre class="brush: js">var Foo = () => {}; -console.log(Foo.prototype); // undefined -</pre> - -<h3 id="Use_of_the_yield_keyword">Use of the <code>yield</code> keyword</h3> - -<p>The <code><a href="/en-US/docs/Web/JavaScript/Reference/Operators/yield">yield</a></code> keyword may not be used in an arrow function's body (except when permitted within functions further nested within it). As a consequence, arrow functions cannot be used as generators.</p> - -<h2 id="Function_body">Function body</h2> - -<p>Arrow functions can have either a "concise body" or the usual "block body".</p> - -<p>In a concise body, only an expression is specified, which becomes the implicit return value. In a block body, you must use an explicit <code>return</code> statement.</p> - -<pre class="brush: js">var func = x => x * x; -// concise body syntax, implied "return" - -var func = (x, y) => { return x + y; }; -// with block body, explicit "return" needed -</pre> - -<h2 id="Returning_object_literals">Returning object literals</h2> - -<p>Keep in mind that returning object literals using the concise body syntax <code>params => {object:literal}</code> will not work as expected.</p> - -<pre class="brush: js">var func = () => { foo: 1 }; -// Calling func() returns undefined! - -var func = () => { foo: function() {} }; -// SyntaxError: function statement requires a name</pre> - -<p>This is because the code inside braces ({}) is parsed as a sequence of statements (i.e. <code>foo</code> is treated like a label, not a key in an object literal).</p> - -<p>You must wrap the object literal in parentheses:</p> - -<pre class="brush: js">var func = () => ({ foo: 1 });</pre> - -<h2 id="Line_breaks">Line breaks</h2> - -<p>An arrow function cannot contain a line break between its parameters and its arrow.</p> - -<pre class="brush: js">var func = (a, b, c) - => 1; -// SyntaxError: expected expression, got '=>'</pre> - -<p>However, this can be amended by putting the line break after the arrow or using parentheses/braces as seen below to ensure that the code stays pretty and fluffy. You can also put line breaks between arguments.</p> - -<pre class="brush: js">var func = (a, b, c) => - 1; - -var func = (a, b, c) => ( - 1 -); - -var func = (a, b, c) => { - return 1 -}; - -var func = ( - a, - b, - c -) => 1; - -// no SyntaxError thrown</pre> - -<h2 id="Parsing_order">Parsing order</h2> - -<p>Although the arrow in an arrow function is not an operator, arrow functions have special parsing rules that interact differently with <a href="/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence">operator precedence</a> compared to regular functions.</p> - -<pre class="brush: js">let callback; - -callback = callback || function() {}; // ok - -callback = callback || () => {}; -// SyntaxError: invalid arrow-function arguments - -callback = callback || (() => {}); // ok -</pre> - -<h2 id="More_examples">More examples</h2> - -<pre class="brush: js">// An empty arrow function returns undefined -let empty = () => {}; - -(() => 'foobar')(); -// Returns "foobar" -// (this is an <a href="/en-US/docs/Glossary/IIFE">Immediately Invoked Function Expression</a>) - -var simple = a => a > 15 ? 15 : a; -simple(16); // 15 -simple(10); // 10 - -let max = (a, b) => a > b ? a : b; - -// Easy array filtering, mapping, ... - -var arr = [5, 6, 13, 0, 1, 18, 23]; - -var sum = arr.reduce((a, b) => a + b); -// 66 - -var even = arr.filter(v => v % 2 == 0); -// [6, 0, 18] - -var double = arr.map(v => v * 2); -// [10, 12, 26, 0, 2, 36, 46] - -// More concise promise chains -promise.then(a => { - // ... -}).then(b => { - // ... -}); - -// Parameterless arrow functions that are visually easier to parse -setTimeout( () => { - console.log('I happen sooner'); - setTimeout( () => { - // deeper code - console.log('I happen later'); - }, 1); -}, 1); -</pre> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-arrow-function-definitions', 'Arrow Function Definitions')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<div> - - -<p>{{Compat("javascript.functions.arrow_functions")}}</p> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="https://hacks.mozilla.org/2015/06/es6-in-depth-arrow-functions/">"ES6 In Depth: Arrow functions" on hacks.mozilla.org</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/functions/index.html b/files/pt-pt/web/javascript/reference/functions/index.html deleted file mode 100644 index b77d914f53..0000000000 --- a/files/pt-pt/web/javascript/reference/functions/index.html +++ /dev/null @@ -1,595 +0,0 @@ ---- -title: Funções -slug: Web/JavaScript/Reference/Functions -tags: - - Constructor - - Função - - Funções - - JavaScript - - Parâmetro - - parâmetros -translation_of: Web/JavaScript/Reference/Functions -original_slug: Web/JavaScript/Reference/Funcoes ---- -<div>{{jsSidebar("Functions")}}</div> - -<p>Generally speaking, a function is a "subprogram" that can be <em>called</em> by code external (or internal in the case of recursion) to the function. Like the program itself, a function is composed of a sequence of statements called the <em>function body</em>. Values can be <em>passed</em> to a function, and the function will <em>return</em> a value.</p> - -<p>In JavaScript, functions are first-class objects, because they can have properties and methods just like any other object. What distinguishes them from other objects is that functions can be called. In brief, they are <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Function">Function</a></code> objects.</p> - -<p>For more examples and explanations, see also the <a href="/en-US/docs/Web/JavaScript/Guide/Functions">JavaScript guide about functions</a>.</p> - -<h2 id="Descrição">Descrição</h2> - -<p>Every function in JavaScript is a <code>Function</code> object. See {{jsxref("Function")}} for information on properties and methods of <code>Function</code> objects.</p> - -<p>To return a value other than the default, a function must have a <code><a href="/en-US/docs/Web/JavaScript/Reference/Statements/return">return</a></code> statement that specifies the value to return. A function without a return statement will return a default value. In the case of a <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/constructor">constructor</a> called with the <code><a href="/en-US/docs/Web/JavaScript/Reference/Operators/new">new</a></code> keyword, the default value is the value of its <code>this</code> parameter. For all other functions, the default return value is {{jsxref("undefined")}}.</p> - -<p>The parameters of a function call are the function's <em>arguments</em>. Arguments are passed to functions <em>by value</em>. If the function changes the value of an argument, this change is not reflected globally or in the calling function. However, object references are values, too, and they are special: if the function changes the referred object's properties, that change is visible outside the function, as shown in the following example:</p> - -<pre class="brush: js">/* Declare the function 'myFunc' */ -function myFunc(theObject) { - theObject.brand = "Toyota"; -} - -/* - * Declare variable 'mycar'; - * create and initialize a new Object; - * assign reference to it to 'mycar' - */ -var mycar = { - brand: "Honda", - model: "Accord", - year: 1998 -}; - -/* Logs 'Honda' */ -console.log(mycar.brand); - -/* Pass object reference to the function */ -myFunc(mycar); - -/* - * Logs 'Toyota' as the value of the 'brand' property - * of the object, as changed to by the function. - */ -console.log(mycar.brand); -</pre> - -<p>The <a href="/en-US/docs/Web/JavaScript/Reference/Operators/this"><code>this</code> keyword</a> does not refer to the currently executing function, so you must refer to <code>Function</code> objects by name, even within the function body.</p> - -<h2 id="Definindo_funções">Definindo funções</h2> - -<p>There are several ways to define functions:</p> - -<h3 id="The_function_declaration_(function_statement)">The function declaration (<code>function</code> statement)</h3> - -<p>There is a special syntax for declaring functions (see <a href="/en-US/docs/Web/JavaScript/Reference/Statements/function">function statement</a> for details):</p> - -<pre class="syntaxbox">function <em>name</em>([<em>param</em>[, <em>param</em>[, ... <em>param</em>]]]) { - <em>statements</em> -} -</pre> - -<dl> - <dt><code>name</code></dt> - <dd>The function name.</dd> -</dl> - -<dl> - <dt><code>param</code></dt> - <dd>The name of an argument to be passed to the function. A function can have up to 255 arguments.</dd> -</dl> - -<dl> - <dt><code>statements</code></dt> - <dd>The statements comprising the body of the function.</dd> -</dl> - -<h3 id="The_function_expression_(function_expression)">The function expression (<code>function</code> expression)</h3> - -<p>A function expression is similar to and has the same syntax as a function declaration (see <a href="/en-US/docs/Web/JavaScript/Reference/Operators/function">function expression</a> for details). A function expression may be a part of a larger expression. One can define "named" function expressions (where the name of the expression might be used in the call stack for example) or "anonymous" function expressions. Function expressions are not <em>hoisted</em> onto the beginning of the scope, therefore they cannot be used before they appear in the code.</p> - -<pre class="syntaxbox">function [<em>name</em>]([<em>param</em>[, <em>param</em>[, ... <em>param</em>]]]) { - <em>statements</em> -} -</pre> - -<dl> - <dt><code>name</code></dt> - <dd>The function name. Can be omitted, in which case the function becomes known as an anonymous function.</dd> -</dl> - -<dl> - <dt><code>param</code></dt> - <dd>The name of an argument to be passed to the function. A function can have up to 255 arguments.</dd> - <dt><code>statements</code></dt> - <dd>The statements comprising the body of the function.</dd> -</dl> - -<p>Here is an example of an <strong>anonymous</strong> function expression (the <code>name</code> is not used):</p> - -<pre class="brush: js">var myFunction = function() { - statements -}</pre> - -<p>It is also possible to provide a name inside the definition in order to create a <strong>named</strong> function expression:</p> - -<pre class="brush: js">var myFunction = function namedFunction(){ - statements -} -</pre> - -<p>One of the benefit of creating a named function expression is that in case we encounted an error, the stack trace will contain the name of the function, making it easier to find the origin of the error.</p> - -<p>As we can see, both examples do not start with the <code>function</code> keyword. Statements involving functions which do not start with <code>function</code> are function expressions.</p> - -<p>When functions are used only once, a common pattern is an <strong>IIFE (<em>Immediately Invokable Function Expression</em>)</strong>.</p> - -<pre class="brush: js">(function() { - statements -})();</pre> - -<p>IIFE are function expressions that are invoked as soon as the function is declared.</p> - -<h3 id="The_generator_function_declaration_(function*_statement)">The generator function declaration (<code>function*</code> statement)</h3> - -<p>There is a special syntax for generator function declarations (see {{jsxref('Statements/function*', 'function* statement')}} for details):</p> - -<pre class="syntaxbox">function* <em>name</em>([<em>param</em>[, <em>param</em>[, ... <em>param</em>]]]) { - <em>statements</em> -} -</pre> - -<dl> - <dt><code>name</code></dt> - <dd>The function name.</dd> -</dl> - -<dl> - <dt><code>param</code></dt> - <dd>The name of an argument to be passed to the function. A function can have up to 255 arguments.</dd> -</dl> - -<dl> - <dt><code>statements</code></dt> - <dd>The statements comprising the body of the function.</dd> -</dl> - -<h3 id="The_generator_function_expression_(function*_expression)">The generator function expression (<code>function*</code> expression)</h3> - -<p>A generator function expression is similar to and has the same syntax as a generator function declaration (see {{jsxref('Operators/function*', 'function* expression')}} for details):</p> - -<pre class="syntaxbox">function* [<em>name</em>]([<em>param</em>[, <em>param</em>[, ... <em>param</em>]]]) { - <em>statements</em> -} -</pre> - -<dl> - <dt><code>name</code></dt> - <dd>The function name. Can be omitted, in which case the function becomes known as an anonymous function.</dd> -</dl> - -<dl> - <dt><code>param</code></dt> - <dd>The name of an argument to be passed to the function. A function can have up to 255 arguments.</dd> - <dt><code>statements</code></dt> - <dd>The statements comprising the body of the function.</dd> -</dl> - -<h3 id="The_arrow_function_expression_(>)">The arrow function expression (=>)</h3> - -<p>An arrow function expression has a shorter syntax and lexically binds its <code>this</code> value (see <a href="/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions">arrow functions</a> for details):</p> - -<pre class="syntaxbox">([param[, param]]) => { - statements -} - -param => expression -</pre> - -<dl> - <dt><code>param</code></dt> - <dd>The name of an argument. Zero arguments need to be indicated with <code>()</code>. For only one argument, the parentheses are not required. (like <code>foo => 1</code>)</dd> - <dt><code>statements or expression</code></dt> - <dd>Multiple statements need to be enclosed in brackets. A single expression requires no brackets. The expression is also the implicit return value of the function.</dd> -</dl> - -<h3 id="The_Function_constructor">The <code>Function</code> constructor</h3> - -<div class="note"> -<p><strong>Note:</strong> Using the <code>Function</code> constructor to create functions is not recommended since it needs the function body as a string which may prevent some JS engine optimizations and can also cause other problems.</p> -</div> - -<p>As all other objects, {{jsxref("Function")}} objects can be created using the <code>new</code> operator:</p> - -<pre class="syntaxbox">new Function (<em>arg1</em>, <em>arg2</em>, ... <em>argN</em>, <em>functionBody</em>) -</pre> - -<dl> - <dt><code>arg1, arg2, ... arg<em>N</em></code></dt> - <dd>Zero or more names to be used by the function as formal parameters. Each must be a proper JavaScript identifier.</dd> -</dl> - -<dl> - <dt><code>functionBody</code></dt> - <dd>A string containing the JavaScript statements comprising the function body.</dd> -</dl> - -<p>Invoking the <code>Function</code> constructor as a function (without using the <code>new</code> operator) has the same effect as invoking it as a constructor.</p> - -<h3 id="The_GeneratorFunction_constructor">The <code>GeneratorFunction</code> constructor</h3> - -<div class="note"> -<p><strong>Note:</strong> <code>GeneratorFunction</code> is not a global object, but could be obtained from generator function instance (see {{jsxref("GeneratorFunction")}} for more detail).</p> -</div> - -<div class="note"> -<p><strong>Note:</strong> Using the <code>GeneratorFunction</code> constructor to create functions is not recommended since it needs the function body as a string which may prevent some JS engine optimizations and can also cause other problems.</p> -</div> - -<p>As all other objects, {{jsxref("GeneratorFunction")}} objects can be created using the <code>new</code> operator:</p> - -<pre class="syntaxbox">new GeneratorFunction (<em>arg1</em>, <em>arg2</em>, ... <em>argN</em>, <em>functionBody</em>) -</pre> - -<dl> - <dt><code>arg1, arg2, ... arg<em>N</em></code></dt> - <dd>Zero or more names to be used by the function as formal argument names. Each must be a string that conforms to the rules for a valid JavaScript identifier or a list of such strings separated with a comma; for example "<code>x</code>", "<code>theValue</code>", or "<code>a,b</code>".</dd> -</dl> - -<dl> - <dt><code>functionBody</code></dt> - <dd>A string containing the JavaScript statements comprising the function definition.</dd> -</dl> - -<p>Invoking the <code>Function</code> constructor as a function (without using the <code>new</code> operator) has the same effect as invoking it as a constructor.</p> - -<h2 id="Parâmetros_de_função">Parâmetros de função</h2> - -<h3 id="Parâmetros_predefinidos">Parâmetros predefinidos</h3> - -<p>Default function parameters allow formal parameters to be initialized with default values if no value or <code>undefined</code> is passed. For more details, see<a href="/en-US/docs/Web/JavaScript/Reference/Functions/Default_parameters"> default parameters</a>.</p> - -<h3 id="Parâmetros_Rest">Parâmetros <em>Rest</em></h3> - -<p>The rest parameter syntax allows to represent an indefinite number of arguments as an array. For more details, see <a href="/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters">rest parameters</a>.</p> - -<h2 id="O_objeto_arguments">O objeto <em><code>arguments</code></em></h2> - -<p>You can refer to a function's arguments within the function by using the <code>arguments</code> object. See <a href="/en-US/docs/Web/JavaScript/Reference/Functions/arguments">arguments</a>.</p> - -<ul> - <li><code><a href="/en-US/docs/JavaScript/Reference/Functions_and_function_scope/arguments">arguments</a></code>: An array-like object containing the arguments passed to the currently executing function.</li> - <li><code><a href="/en-US/docs/JavaScript/Reference/Functions_and_function_scope/arguments/callee">arguments.callee</a></code> {{Deprecated_inline}}: The currently executing function.</li> - <li><code><a href="/en-US/docs/JavaScript/Reference/Functions_and_function_scope/arguments/caller">arguments.caller</a></code> {{Obsolete_inline}} : The function that invoked the currently executing function.</li> - <li><code><a href="/en-US/docs/JavaScript/Reference/Functions_and_function_scope/arguments/length">arguments.length</a></code>: The number of arguments passed to the function.</li> -</ul> - -<h2 id="Definindo_funções_de_método">Definindo funções de método</h2> - -<h3 id="Getter_and_setter_functions">Getter and setter functions</h3> - -<p>You can define getters (accessor methods) and setters (mutator methods) on any standard built-in object or user-defined object that supports the addition of new properties. The syntax for defining getters and setters uses the object literal syntax.</p> - -<dl> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Functions/get">get</a></dt> - <dd> - <p>Binds an object property to a function that will be called when that property is looked up.</p> - </dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Functions/set">set</a></dt> - <dd>Binds an object property to a function to be called when there is an attempt to set that property.</dd> -</dl> - -<h3 id="Method_definition_syntax">Method definition syntax</h3> - -<p>Starting with ECMAScript 2015, you are able to define own methods in a shorter syntax, similar to the getters and setters. See <a href="/en-US/docs/Web/JavaScript/Reference/Functions/Method_definitions">method definitions</a> for more information.</p> - -<pre class="brush: js">var obj = { - foo() {}, - bar() {} -};</pre> - -<h2 id="Constructor_vs._declaration_vs._expression">Constructor vs. declaration vs. expression</h2> - -<p>Compare the following:</p> - -<p>A function defined with the <code>Function</code> <em>constructor</em> assigned to the variable <code>multiply:</code></p> - -<pre class="brush: js">var multiply = new Function('x', 'y', 'return x * y');</pre> - -<p>A <em>function declaration</em> of a function named <code>multiply</code>:</p> - -<pre class="brush: js">function multiply(x, y) { - return x * y; -} // there is no semicolon here -</pre> - -<p>A <em>function expression</em> of an anonymous function assigned to the variable <code>multiply:</code></p> - -<pre class="brush: js">var multiply = function(x, y) { - return x * y; -}; -</pre> - -<p>A <em>function expression</em> of a function named <code>func_name</code> assigned to the variable <code>multiply:</code></p> - -<pre class="brush: js">var multiply = function func_name(x, y) { - return x * y; -}; -</pre> - -<h3 id="Differences">Differences</h3> - -<p>All do approximately the same thing, with a few subtle differences:</p> - -<p>There is a distinction between the function name and the variable the function is assigned to. The function name cannot be changed, while the variable the function is assigned to can be reassigned. The function name can be used only within the function's body. Attempting to use it outside the function's body results in an error (or <code>undefined</code> if the function name was previously declared via a <code>var</code> statement). For example:</p> - -<pre class="brush: js">var y = function x() {}; -alert(x); // throws an error -</pre> - -<p>The function name also appears when the function is serialized via <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/toString"><code>Function</code>'s toString method</a>.</p> - -<p>On the other hand, the variable the function is assigned to is limited only by its scope, which is guaranteed to include the scope in which the function is declared.</p> - -<p>As the 4th example shows, the function name can be different from the variable the function is assigned to. They have no relation to each other. A function declaration also creates a variable with the same name as the function name. Thus, unlike those defined by function expressions, functions defined by function declarations can be accessed by their name in the scope they were defined in:</p> - -<p>A function defined by '<code>new Function'</code> does not have a function name. However, in the <a href="/en-US/docs/Mozilla/Projects/SpiderMonkey">SpiderMonkey</a> JavaScript engine, the serialized form of the function shows as if it has the name "anonymous". For example, <code>alert(new Function())</code> outputs:</p> - -<pre class="brush: js">function anonymous() { -} -</pre> - -<p>Since the function actually does not have a name, <code>anonymous</code> is not a variable that can be accessed within the function. For example, the following would result in an error:</p> - -<pre class="brush: js">var foo = new Function("alert(anonymous);"); -foo(); -</pre> - -<p>Unlike functions defined by function expressions or by the <code>Function</code> constructor, a function defined by a function declaration can be used before the function declaration itself. For example:</p> - -<pre class="brush: js">foo(); // alerts FOO! -function foo() { - alert('FOO!'); -} -</pre> - -<p>A function defined by a function expression or by a function declaration inherits the current scope. That is, the function forms a closure. On the other hand, a function defined by a <code>Function</code> constructor does not inherit any scope other than the global scope (which all functions inherit).</p> - -<pre class="brush: js">/* - * Declare and initialize a variable 'p' (global) - * and a function 'myFunc' (to change the scope) inside which - * declare a varible with same name 'p' (current) and - * define three functions using three different ways:- - * 1. function declaration - * 2. function expression - * 3. function constructor - * each of which will log 'p' - */ -var p = 5; -function myFunc() { - var p = 9; - - function decl() { - console.log(p); - } - var expr = function() { - console.log(p); - }; - var cons = new Function('\tconsole.log(p);'); - - decl(); - expr(); - cons(); -} -myFunc(); - -/* - * Logs:- - * 9 - for 'decl' by function declaration (current scope) - * 9 - for 'expr' by function expression (current scope) - * 5 - for 'cons' by Function constructor (global scope) - */ -</pre> - -<p>Functions defined by function expressions and function declarations are parsed only once, while those defined by the <code>Function</code> constructor are not. That is, the function body string passed to the <code>Function</code> constructor must be parsed each and every time the constructor is called. Although a function expression creates a closure every time, the function body is not reparsed, so function expressions are still faster than "<code>new Function(...)</code>". Therefore the <code>Function</code> constructor should generally be avoided whenever possible.</p> - -<p>It should be noted, however, that function expressions and function declarations nested within the function generated by parsing a <code>Function constructor</code> 's string aren't parsed repeatedly. For example:</p> - -<pre class="brush: js">var foo = (new Function("var bar = \'FOO!\';\nreturn(function() {\n\talert(bar);\n});"))(); -foo(); // The segment "function() {\n\talert(bar);\n}" of the function body string is not re-parsed.</pre> - -<p>A function declaration is very easily (and often unintentionally) turned into a function expression. A function declaration ceases to be one when it either:</p> - -<ul> - <li>becomes part of an expression</li> - <li>is no longer a "source element" of a function or the script itself. A "source element" is a non-nested statement in the script or a function body:</li> -</ul> - -<pre class="brush: js">var x = 0; // source element -if (x === 0) { // source element - x = 10; // not a source element - function boo() {} // not a source element -} -function foo() { // source element - var y = 20; // source element - function bar() {} // source element - while (y === 10) { // source element - function blah() {} // not a source element - y++; // not a source element - } -} -</pre> - -<h3 id="Examples">Examples</h3> - -<pre class="brush: js">// function declaration -function foo() {} - -// function expression -(function bar() {}) - -// function expression -x = function hello() {} - - -if (x) { - // function expression - function world() {} -} - - -// function declaration -function a() { - // function declaration - function b() {} - if (0) { - // function expression - function c() {} - } -} -</pre> - -<h2 id="Block-level_functions">Block-level functions</h2> - -<p>In <a href="/en-US/docs/Web/JavaScript/Reference/Strict_mode">strict mode</a>, starting with ES2015, functions inside blocks are now scoped to that block. Prior to ES2015, block-level functions were forbidden in strict mode.</p> - -<pre class="brush: js">'use strict'; - -function f() { - return 1; -} - -{ - function f() { - return 2; - } -} - -f() === 1; // true - -// f() === 2 in non-strict mode -</pre> - -<h3 id="Block-level_functions_in_non-strict_code">Block-level functions in non-strict code</h3> - -<p>In a word: Don't.</p> - -<p>In non-strict code, function declarations inside blocks behave strangely. For example:</p> - -<pre class="brush: js">if (shouldDefineZero) { - function zero() { // DANGER: compatibility risk - console.log("This is zero."); - } -} -</pre> - -<p>ES2015 says that if <code>shouldDefineZero</code> is false, then <code>zero</code> should never be defined, since the block never executes. However, it's a new part of the standard. Historically, this was left unspecified, and some browsers would define <code>zero</code> whether the block executed or not.</p> - -<p>In <a href="/en-US/docs/Web/JavaScript/Reference/Strict_mode">strict mode</a>, all browsers that support ES2015 handle this the same way: <code>zero</code> is defined only if <code>shouldDefineZero</code> is true, and only in the scope of the <code>if</code>-block.</p> - -<p>A safer way to define functions conditionally is to assign a function expression to a variable:</p> - -<pre class="brush: js">var zero; -if (shouldDefineZero) { - zero = function() { - console.log("This is zero."); - }; -} -</pre> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Returning_a_formatted_number">Returning a formatted number</h3> - -<p>The following function returns a string containing the formatted representation of a number padded with leading zeros.</p> - -<pre class="brush: js">// This function returns a string padded with leading zeros -function padZeros(num, totalLen) { - var numStr = num.toString(); // Initialize return value as string - var numZeros = totalLen - numStr.length; // Calculate no. of zeros - for (var i = 1; i <= numZeros; i++) { - numStr = "0" + numStr; - } - return numStr; -} -</pre> - -<p>The following statements call the padZeros function.</p> - -<pre class="brush: js">var result; -result = padZeros(42,4); // returns "0042" -result = padZeros(42,2); // returns "42" -result = padZeros(5,4); // returns "0005" -</pre> - -<h3 id="Determining_whether_a_function_exists">Determining whether a function exists</h3> - -<p>You can determine whether a function exists by using the <code>typeof</code> operator. In the following example, a test is performed to determine if the <code>window</code> object has a property called <code>noFunc</code> that is a function. If so, it is used; otherwise some other action is taken.</p> - -<pre class="brush: js"> if ('function' === typeof window.noFunc) { - // use noFunc() - } else { - // do something else - } -</pre> - -<p>Note that in the <code>if</code> test, a reference to <code>noFunc</code> is used—there are no brackets "()" after the function name so the actual function is not called.</p> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition. Implemented in JavaScript 1.0</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-13', 'Function Definition')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-function-definitions', 'Function definitions')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>New: Arrow functions, Generator functions, default parameters, rest parameters.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-function-definitions', 'Function definitions')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - - - -<p>{{Compat("javascript.functions")}}</p> - -<h2 id="Consulte_também">Consulte também</h2> - -<ul> - <li>{{jsxref("Statements/function", "function statement")}}</li> - <li>{{jsxref("Operators/function", "function expression")}}</li> - <li>{{jsxref("Statements/function*", "function* statement")}}</li> - <li>{{jsxref("Operators/function*", "function* expression")}}</li> - <li>{{jsxref("Function")}}</li> - <li>{{jsxref("GeneratorFunction")}}</li> - <li>{{jsxref("Functions/Arrow_functions", "Arrow functions")}}</li> - <li>{{jsxref("Functions/Default_parameters", "Default parameters")}}</li> - <li>{{jsxref("Functions/rest_parameters", "Rest parameters")}}</li> - <li>{{jsxref("Functions/arguments", "Arguments object")}}</li> - <li>{{jsxref("Functions/get", "getter")}}</li> - <li>{{jsxref("Functions/set", "setter")}}</li> - <li>{{jsxref("Functions/Method_definitions", "Method definitions")}}</li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions_and_function_scope">Functions and function scope</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/functions/rest_parameters/index.html b/files/pt-pt/web/javascript/reference/functions/rest_parameters/index.html deleted file mode 100644 index 357ce41efa..0000000000 --- a/files/pt-pt/web/javascript/reference/functions/rest_parameters/index.html +++ /dev/null @@ -1,235 +0,0 @@ ---- -title: Parâmetros Rest -slug: Web/JavaScript/Reference/Functions/rest_parameters -tags: - - Funcionalidade Linguagem - - Funções - - JavaScript - - Parametros Rest - - Rest -translation_of: Web/JavaScript/Reference/Functions/rest_parameters -original_slug: Web/JavaScript/Reference/Funcoes/parametros_rest ---- -<div>Parâmetrois {{jsSidebar("Functions")}}</div> - -<p><span class="seoSummary">A sintaxe do <strong>parâmetro "rest"</strong> permite-nos representar um número indefinido de argumentos</span><span class="seoSummary">como um <em>array</em>.</span></p> - -<div>{{EmbedInteractiveExample("pages/js/functions-restparameters.html")}}</div> - - - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox">function f(<var>a</var>, <var>b</var>, ...<var>theArgs</var>) { - // ... -}</pre> - -<h2 id="Descrição">Descrição</h2> - -<p>A function's last parameter can be prefixed with <code>...</code> which will cause all remaining (user supplied) arguments to be placed within a "standard" Javascript array.</p> - -<p>Only the last parameter can be a "rest parameter".</p> - -<pre class="brush: js">function myFun(<var>a</var>, <var>b</var>, ...<var>manyMoreArgs</var>) { - console.log("a", a) - console.log("b", b) - console.log("manyMoreArgs", manyMoreArgs) -} - -myFun("one", "two", "three", "four", "five", "six") - -// Console Output: -// a, one -// b, two -// manyMoreArgs, [three, four, five, six] -</pre> - -<h3 id="Difference_between_rest_parameters_and_the_arguments_object">Difference between rest parameters and the <code>arguments</code> object</h3> - -<p>There are three main differences between rest parameters and the {{jsxref("Functions/arguments", "arguments")}} object:</p> - -<ul> - <li>rest parameters are only the ones that haven't been given a separate name (i.e. formally defined in function expression), while the <code>arguments</code> object contains <em>all</em> arguments passed to the function;</li> - <li>the <code>arguments</code> object is not a real array, while rest parameters are {{jsxref("Global_Objects/Array", "Array")}} instances, meaning methods like {{jsxref("Array.sort", "sort")}}, {{jsxref("Array.map", "map")}}, {{jsxref("Array.forEach", "forEach")}} or {{jsxref("Array/pop", "pop")}} can be applied on it directly;</li> - <li>the <code>arguments</code> object has additional functionality specific to itself (like the <code>callee</code> property).</li> -</ul> - -<h3 id="From_arguments_to_an_array">From arguments to an array</h3> - -<p>Rest parameters have been introduced to reduce the boilerplate code that was induced by the arguments</p> - -<pre class="brush: js">// Before rest parameters, "arguments" could be converted to a normal array using: - -function f(a, b) { - - let normalArray = Array.prototype.slice.call(arguments) - // -- or -- - let normalArray = [].slice.call(arguments) - // -- or -- - let normalArray = Array.from(arguments) - - let first = normalArray.shift() // OK, gives the first argument - let first = arguments.shift() // ERROR (arguments is not a normal array) -} - -// Now, you can easily gain access to a normal array using a rest parameter - -function f(...args) { - let normalArray = args - let first = normalArray.shift() // OK, gives the first argument -} -</pre> - -<h3 id="Destructuring_rest_parameters">Destructuring rest parameters</h3> - -<p>Rest parameters can be destructured Arrays only (though objects will soon be supported). That means that their data can be unpacked into distinct variables. (See <a href="/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment">Destructuring assignment</a>.)</p> - -<pre class="brush: js">function f(...[a, b, c]) { - return a + b + c; -} - -f(1) // NaN (b and c are undefined) -f(1, 2, 3) // 6 -f(1, 2, 3, 4) // 6 (the fourth parameter is not destructured) -</pre> - -<div class="blockIndicator note"> -<h4 id="Fixme">Fixme</h4> - -<p><s>Doing this is possible, but (afaik) there's no use-case, so it's just confusing the junior audience. The following code does exactly the same. There should at least be a note, that in theory you can do something like this, but there is no point in doing so.</s> The example is contrived, but imagine that [a, b, c] were the return value of some function. Then the utility is clear.</p> - -<p><s>Also, since <a href="/en-US/docs/Web/JavaScript/Reference/Functions/arguments">Function arguments</a> will never have named parameters (this is not Python), the statement "objects will soon be supported" is wrong. </s> The preceding example may be mixing up destructuring with rest parameters. Please see the <a href="/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment">page on destructuring assignment</a> for an example with object destructuring applied in the parameters area.</p> - -<pre class="brush: js">function f(a, b, c) { - return a + b + c -} - -f(1) // NaN (b and c are undefined) -f(1, 2, 3) // 6 -f(1, 2, 3, 4) // 6 (the fourth parameter is not ...) -</pre> -</div> - -<h2 id="Exemplos">Exemplos</h2> - -<p>In this example, the first argument is mapped to <code>a</code> and the second to <code>b</code>, so these named arguments are used like normal.</p> - -<p>However, the third argument, <code>manyMoreArgs</code>, will be an array that contains the 3<sup>rd</sup>, 4<sup>th</sup>, 5<sup>th</sup>, 6<sup>th</sup> ... <var>n</var><sup>th</sup> — as many arguments that the user includes.</p> - -<pre class="brush: js">function myFun(a, b, ...manyMoreArgs) { - console.log("a", a) - console.log("b", b) - console.log("manyMoreArgs", manyMoreArgs) -} - -myFun("one", "two", "three", "four", "five", "six") - -// a, one -// b, two -// manyMoreArgs, [three, four, five, six] -</pre> - -<p>Below... even though there is just one value, the last argument still gets put into an array.</p> - -<pre class="brush: js">// using the same function definition from example above - -myFun("one", "two", "three") - -// a, one -// b, two -// manyMoreArgs, [three]</pre> - -<p>Below, the third argument isn't provided, but <code>manyMoreArgs</code> is still an array (albeit an empty one).</p> - -<pre class="brush: js">// using the same function definition from example above - -myFun("one", "two") - -// a, one -// b, two -// manyMoreArgs, []</pre> - -<p>Since <code>theArgs</code> is an array, a count of its elements is given by the <code>length</code> property:</p> - -<pre class="brush: js">function fun1(...theArgs) { - console.log(theArgs.length) -} - -fun1() // 0 -fun1(5) // 1 -fun1(5, 6, 7) // 3 -</pre> - -<p>In the next example, a rest parameter is used to collect all parameters after the first into an array. Each one of them is then multiplied by the first parameter, and the array is returned:</p> - -<pre class="brush: js">function multiply(multiplier, ...theArgs) { - return theArgs.map(function(element) { - return multiplier * element - }) -} - -let arr = multiply(2, 1, 2, 3) -console.log(arr) // [2, 4, 6] -</pre> - -<p><code>Array</code> methods can be used on rest parameters, but not on the <code>arguments</code> object:</p> - -<pre class="brush: js">function sortRestArgs(...theArgs) { - let sortedArgs = theArgs.sort() - return sortedArgs -} - -console.log(sortRestArgs(5, 3, 7, 1)) // 1, 3, 5, 7 - -function sortArguments() { - let sortedArgs = arguments.sort() - return sortedArgs // this will never happen -} - - -console.log(sortArguments(5, 3, 7, 1)) -// throws a TypeError (arguments.sort is not a function) -</pre> - -<p>To use <code>Array</code> methods on the <code>arguments</code> object, it must be converted to a real array first.</p> - -<pre class="brush: js">function sortArguments() { - let args = Array.from(arguments) - let sortedArgs = args.sort() - return sortedArgs -} -console.log(sortArguments(5, 3, 7, 1)) // 1, 3, 5, 7 -</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-function-definitions', 'Function Definitions')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibildiade_de_navegador">Compatibildiade de navegador</h2> - - - -<p>{{Compat("javascript.functions.rest_parameters")}}</p> - -<h2 id="Consulte_também">Consulte também</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Spread_operator" title="spread operator">Spread syntax</a> (also ‘<code>...</code>’)</li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions/arguments" title="arguments">Arguments object</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" title="Array">Array</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions" title="Functions and function scope">Functions</a></li> - <li><a class="external" href="http://wiki.ecmascript.org/doku.php?id=harmony:rest_parameters">Original proposal at ecmascript.org</a></li> - <li><a class="external" href="http://javascriptweblog.wordpress.com/2011/01/18/javascripts-arguments-object-and-beyond/">JavaScript arguments object and beyond</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment">Destructuring assignment</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/array/concat/index.html b/files/pt-pt/web/javascript/reference/global_objects/array/concat/index.html deleted file mode 100644 index 237818a04c..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/array/concat/index.html +++ /dev/null @@ -1,205 +0,0 @@ ---- -title: Array.prototype.concat() -slug: Web/JavaScript/Reference/Global_Objects/Array/concat -tags: - - JavaScript - - Prototipo - - Referencia - - Vector - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Array/concat ---- -<div>{{JSRef}}</div> - -<p>O método <code><strong>concat()</strong></code> é usado para concatenar dois ou mais vectores. Este método não altera os vectores existentes, devolvendo ao invés um novo vector.</p> - -<pre class="brush: js">var vec1 = ['a', 'b', 'c']; -var vec2 = ['d', 'e', 'f']; - -var vec3 = vec1.concat(vec2); - -// vec3 é um novo vector [ "a", "b", "c", "d", "e", "f" ]</pre> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox">var <var>novo_vector</var> = <var>velho_vector</var>.concat(<var>valor1</var>[, <var>valor2</var>[, ...[, <var>valorN</var>]]])</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>valor<em>N</em></code></dt> - <dd>Vectores e/ou valores a concatenar num novo vector. Veja a descrição detalhada abaixo.</dd> -</dl> - -<h3 id="Valor_devolvido">Valor devolvido</h3> - -<p>Uma nova instância de {{jsxref("Array")}}.</p> - -<h2 id="Descrição">Descrição</h2> - -<p>O método <code>concat</code> cria um novo vector constituído pelos elementos no vector em que foi chamado, seguidos por ordem por, cada argumento, os elementos desse argumento (se o argumento é um vector), ou o argumento em si (se o argumento não é um vector). Não entra recursivamente em vectores inclusos.</p> - -<p>O método <code>concat</code> não altera <code>this</code> ou qualquer dos vectores fornecidos como argumentos, devolve sim uma cópia superficial (shallow copy) que contém cópias dos mesmos elementos combinados dos vectores originais. Os elementos dos vectores originais são copiados para o novo vector da seguinte forma:</p> - -<ul> - <li>Object references (and not the actual object): <code>concat</code> copies object references into the new array. Both the original and new array refer to the same object. That is, if a referenced object is modified, the changes are visible to both the new and original arrays. This includes elements of array arguments that are also arrays.</li> - <li>Strings, numbers and booleans (not {{jsxref("Global_Objects/String", "String")}}, {{jsxref("Global_Objects/Number", "Number")}}, and {{jsxref("Global_Objects/Boolean", "Boolean")}} objects): <code>concat</code> copies the values of strings and numbers into the new array.</li> -</ul> - -<div class="note"> -<p><strong>Note:</strong> Concatenating array(s)/value(s) will leave the originals untouched. Furthermore, any operation on the new array(only if the element is not object reference) will have no effect on the original arrays, and vice versa.</p> -</div> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Concatenar_dois_vectores">Concatenar dois vectores</h3> - -<p>O código que se segue concatena dois vectores:</p> - -<pre class="brush: js">var alfa = ['a', 'b', 'c']; -var numerico = [1, 2, 3]; - -alfa.concat(numerico); -// resulta em ['a', 'b', 'c', 1, 2, 3] -</pre> - -<h3 id="Concatenar_três_vectores">Concatenar três vectores</h3> - -<p>O código que se segue concatena três vectores:</p> - -<pre class="brush: js">var num1 = [1, 2, 3], - num2 = [4, 5, 6], - num3 = [7, 8, 9]; - -var nums = num1.concat(num2, num3); - -console.log(nums); -// resulta em [1, 2, 3, 4, 5, 6, 7, 8, 9] -</pre> - -<h3 id="Concatenar_valores_para_um_vector">Concatenar valores para um vector</h3> - -<p>O código que se segue concatena três valores a um vector:</p> - -<pre class="brush: js">var alfa = ['a', 'b', 'c']; - -var alfaNumerico = alfa.concat(1, [2, 3]); - -console.log(alphaNumeric); -// resulta em ['a', 'b', 'c', 1, 2, 3] -</pre> - -<h3 id="Concatenar_vectores_inclusos">Concatenar vectores inclusos</h3> - -<p>O código que se segue concatena vectores inclusos e demonstra retenção de referências:</p> - -<pre class="brush: js">var num1 = [[1]]; -var num2 = [2, [3]]; - -var nums = num1.concat(num2); - -console.log(nums); -// resulta em [[1], 2, [3]] - -// modificar o primeiro elemento de num1 -num1[0].push(4); - -console.log(nums); -// resulta em [[1, 4], 2, [3]] -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Definição inicial. Implementado no JavaScript 1.2.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.4.4.4', 'Array.prototype.concat')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-array.prototype.concat', 'Array.prototype.concat')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-array.prototype.concat', 'Array.prototype.concat')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Característica</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Edge</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatChrome("1.0")}}</td> - <td>{{CompatGeckoDesktop("1.7")}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatIE("5.5")}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Característica</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("Array.push", "push")}} / {{jsxref("Array.pop", "pop")}} — adicionar/eliminar elementos no fim do vector</li> - <li>{{jsxref("Array.unshift", "unshift")}} / {{jsxref("Array.shift", "shift")}} — adicionar/eliminar elementos no início do vector</li> - <li>{{jsxref("Array.splice", "splice")}} — adicionar e/ou eliminar elementos no local especificado do vector</li> - <li>{{jsxref("String.prototype.concat()")}}</li> - <li>{{jsxref("Symbol.isConcatSpreadable")}} – control flattening.</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/array/find/index.html b/files/pt-pt/web/javascript/reference/global_objects/array/find/index.html deleted file mode 100644 index 3eedeb54a9..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/array/find/index.html +++ /dev/null @@ -1,210 +0,0 @@ ---- -title: Array.prototype.find() -slug: Web/JavaScript/Reference/Global_Objects/Array/find -tags: - - Array - - ECMAScript 2015 - - JavaScript - - Method - - polyfill -translation_of: Web/JavaScript/Reference/Global_Objects/Array/find ---- -<div>{{JSRef}}</div> - -<p>O método <code><strong>find()</strong></code> retorna o <strong>valor</strong> do primeiro elemento do array que satisfaça a função de teste fornecida. Caso contrário o valor {{jsxref("undefined")}} é retornado.</p> - -<div>{{EmbedInteractiveExample("pages/js/array-find.html")}}</div> - - - -<p>Ver também o método {{jsxref("Array.findIndex", "findIndex()")}} , o qual retorna o <strong>index</strong> de um elemento encontrado num array, em alternativa do seu valor.</p> - -<p>É possível obter a posição de um elemento ou verificar a sua existência num array, através da função {{jsxref("Array.prototype.indexOf()")}} ou {{jsxref("Array.prototype.includes()")}}.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><var>arr</var>.find(<var>callback</var>[, <var>thisArg</var>])</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>callback</code></dt> - <dd>Função a executar em cada elemento do array, utilizando três argumentos: - <dl> - <dt><code>element</code></dt> - <dd>O elemento a ser processado no array.</dd> - <dt><code>index</code>{{optional_inline}}</dt> - <dd>O index do elemento a ser processado no array.</dd> - <dt><code>array</code>{{optional_inline}}</dt> - <dd>O array no qual o método <code>find</code> foi chamado.</dd> - </dl> - </dd> - <dt><code>thisArg</code> <code>{{Optional_inline}}</code></dt> - <dd>Objeto para usar como <code>this</code> ao executar a <code>callback</code>.</dd> -</dl> - -<h3 id="Valor_de_retorno">Valor de retorno</h3> - -<p>Um valor do array caso um elemento passe no teste; caso contrário, {{jsxref("undefined")}}.</p> - -<h2 id="Descrição">Descrição</h2> - -<p>O método<code>find</code> executa a <code>callback</code> uma vez para cada index do array até ser encontrado um no qual a <code>callback</code> retorna o valor true. Caso um elemento seja encontrado, o método <code>find</code> retorna imediatamente o seu valor. Caso contrário, o método <code>find</code> retorna {{jsxref("undefined")}}. A função de <code>callback</code> é invocada para cada index do array do <code>0</code> ao <code>length - 1</code> e é invocada para todos os indexes, não apenas nos que tem valor. Isto pode significar que é menos eficiente para o um array com muitos elementos sem valor (sparse array) do que outros métodos que visitam apenas os elementos com valor.</p> - -<p>A função de <code>callback</code> é invocada com 3 parâmetros: o valor do elemento, o index do elemento, e o Array no qual é executado.</p> - -<p>Se o parâmetro <code>thisArg</code> for disponibilizado ao método <code>find</code>, este será usado como <code>this</code> para cada invocação da <code>callback</code>. Caso contrário, será usado o valor {{jsxref("undefined")}}.</p> - -<p>O método <code>find</code> não altera o array no qual é invocado.</p> - -<p>A quantidade de elementos processados pelo método <code>find</code> é definida antes da invocação da <code>callback</code>. Os elementos adicionados ao array após o método <code>find</code> ter iniciado não serão visitados pela <code>callback</code>. Se um elemento existente e não visitado, for alterado pela <code>callback</code>, o seu valor que foi passado para a <code>callback</code> será o valor a ser avaliado pelo método <code>find</code>; Os elementos eliminados após o inicio do método find também serão visitados.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Encontrar_um_objeto_num_array_através_de_uma_das_suas_propriedades">Encontrar um objeto num array através de uma das suas propriedades</h3> - -<pre class="brush: js">var inventory = [ - {name: 'apples', quantity: 2}, - {name: 'bananas', quantity: 0}, - {name: 'cherries', quantity: 5} -]; - -function isCherries(fruit) { - return fruit.name === 'cherries'; -} - -console.log(inventory.find(isCherries)); -// { name: 'cherries', quantity: 5 }</pre> - -<h3 id="Encontrar_um_número_primo_num_array">Encontrar um número primo num array</h3> - -<p>O seguinte exemplo encontra um elemento no array que seja um número primo (caso não exista, retorna {{jsxref("undefined")}} ).</p> - -<pre class="brush: js">function isPrime(element, index, array) { - var start = 2; - while (start <= Math.sqrt(element)) { - if (element % start++ < 1) { - return false; - } - } - return element > 1; -} - -console.log([4, 6, 8, 12].find(isPrime)); // undefined, not found -console.log([4, 5, 8, 12].find(isPrime)); // 5 -</pre> - -<p>O seguinte exemplo, apresenta como os elementos não existentes e eliminados são visitados e o seu valor passado para a callback será o seu valor quando visitado.</p> - -<pre class="brush: js">// Declare array with no element at index 2, 3 and 4 -var a = [0,1,,,,5,6]; - -// Shows all indexes, not just those that have been assigned values -a.find(function(value, index) { - console.log('Visited index ' + index + ' with value ' + value); -}); - -// Shows all indexes, including deleted -a.find(function(value, index) { - - // Delete element 5 on first iteration - if (index == 0) { - console.log('Deleting a[5] with value ' + a[5]); - delete a[5]; - } - // Element 5 is still visited even though deleted - console.log('Visited index ' + index + ' with value ' + value); -}); - -</pre> - -<h2 id="Polyfill">Polyfill</h2> - -<p>Este método foi adicionado ao <em>ECMAScript 2015 Language Specification </em>e pode não estar disponível em todas as implementações de JavaScript. É possível desenvolver o polyfill do método find com o seguinte código:</p> - -<pre class="brush: js">// https://tc39.github.io/ecma262/#sec-array.prototype.find -if (!Array.prototype.find) { - Object.defineProperty(Array.prototype, 'find', { - value: function(predicate) { - // 1. Let O be ? ToObject(this value). - if (this == null) { - throw new TypeError('"this" is null or not defined'); - } - - var o = Object(this); - - // 2. Let len be ? ToLength(? Get(O, "length")). - var len = o.length >>> 0; - - // 3. If IsCallable(predicate) is false, throw a TypeError exception. - if (typeof predicate !== 'function') { - throw new TypeError('predicate must be a function'); - } - - // 4. If thisArg was supplied, let T be thisArg; else let T be undefined. - var thisArg = arguments[1]; - - // 5. Let k be 0. - var k = 0; - - // 6. Repeat, while k < len - while (k < len) { - // a. Let Pk be ! ToString(k). - // b. Let kValue be ? Get(O, Pk). - // c. Let testResult be ToBoolean(? Call(predicate, T, « kValue, k, O »)). - // d. If testResult is true, return kValue. - var kValue = o[k]; - if (predicate.call(thisArg, kValue, k, o)) { - return kValue; - } - // e. Increase k by 1. - k++; - } - - // 7. Return undefined. - return undefined; - } - }); -} -</pre> - -<p>É melhor não utilizar o polyfill <code>Array.prototype</code> para motores JavaScript obsoletos que não suportem métodos <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty">Object.defineProperty</a></code>, uma vez que, não é possível torna-los não-enumeráveis.</p> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-array.prototype.find', 'Array.prototype.find')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-array.prototype.find', 'Array.prototype.find')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_Browsers">Compatibilidade de Browsers</h2> - -<div> - - -<p>{{Compat("javascript.builtins.Array.find")}}</p> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{jsxref("Array.prototype.findIndex()")}} – procurar e obter um index</li> - <li>{{jsxref("Array.prototype.includes()")}} – testar se existe um valor num array</li> - <li>{{jsxref("Array.prototype.filter()")}} – encontrar todos os elementos</li> - <li>{{jsxref("Array.prototype.every()")}} – testar se todos os elementos cumprem o requisito</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/array/foreach/index.html b/files/pt-pt/web/javascript/reference/global_objects/array/foreach/index.html deleted file mode 100644 index 77e1bcc9d9..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/array/foreach/index.html +++ /dev/null @@ -1,328 +0,0 @@ ---- -title: Array.prototype.forEach() -slug: Web/JavaScript/Reference/Global_Objects/Array/forEach -translation_of: Web/JavaScript/Reference/Global_Objects/Array/forEach ---- -<div>{{JSRef}}</div> - -<p>O método <code><strong>forEach()</strong></code> executa a função que foi fornecida uma vez para cada elemento do vetor (array).</p> - -<div>{{EmbedInteractiveExample("pages/js/array-foreach.html")}}</div> - -<p class="hidden">A origem deste exemplo interactivo está armazenado num repositório do GitHub. Se queres contribuir para o projecto dos exemplos interactivos, por favor clona <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> e manda-nos um pull request.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><var>vet</var>.forEach(function <var>callback(presenteValor[, indice[, vetor]]) { - //o teu iterador -}</var>[, <var>argThis</var>]);</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>callback</code></dt> - <dd>Função a executar para cada elemento, levando três argumentos: - <dl> - <dt><code>presenteValor</code></dt> - <dd>Valor do presente elemento a ser processado do vetor (array).</dd> - <dt><code>indice</code>{{optional_inline}}</dt> - <dd>Índice do presente elemento a ser processado do vetor (array).</dd> - <dt><code>vet</code>{{optional_inline}}</dt> - <dd>O vetor (array) a que o <code>forEach()</code> está a ser aplicado.</dd> - </dl> - </dd> - <dt><code>argThis</code> {{Optional_inline}}</dt> - <dd> - <p>Valor a usar como <code><strong>this</strong></code> (ou seja o <code>Object</code> de referência) quando é executado o <code>callback</code>.</p> - </dd> -</dl> - -<h3 id="Valor_devolvido">Valor devolvido</h3> - -<p>{{jsxref("undefined")}}.</p> - -<h2 id="Descrição">Descrição</h2> - -<p><code>forEach()</code> executa o <code>callback</code> fornecido uma vez para cada elemento presente no vetor (array) por ordem ascendente. Não é invocado para indices de propriedades que foram apagadas ou que não foram inicializadas (ou seja em sparse arrays).</p> - -<p><code>callback</code> é invocado com <strong>três argumentos</strong>:</p> - -<ul> - <li>o <strong>valor do elemento</strong></li> - <li>o <strong>índice do elemento</strong></li> - <li>o <strong>vetor (array) que está a ser percorrido</strong></li> -</ul> - -<p>If a <code>thisArg</code> parameter is provided to <code>forEach()</code>, it will be used as callback's <code>this</code> value. Otherwise, the value {{jsxref("undefined")}} will be used as its <code>this</code> value. The <code>this</code> value ultimately observable by <code>callback</code> is determined according to <a href="/en-US/docs/Web/JavaScript/Reference/Operators/this">the usual rules for determining the <code>this</code> seen by a function</a>.</p> - -<p>The range of elements processed by <code>forEach()</code> is set before the first invocation of <code>callback</code>. Elements that are appended to the array after the call to <code>forEach()</code> begins will not be visited by <code>callback</code>. If the values of existing elements of the array are changed, the value passed to <code>callback</code> will be the value at the time <code>forEach()</code> visits them; elements that are deleted before being visited are not visited. If elements that are already visited are removed (e.g. using {{jsxref("Array.prototype.shift()", "shift()")}}) during the iteration, later elements will be skipped - see example below.</p> - -<p><code>forEach()</code> executes the <code>callback</code> function once for each array element; unlike {{jsxref("Array.prototype.map()", "map()")}} or {{jsxref("Array.prototype.reduce()", "reduce()")}} it always returns the value {{jsxref("undefined")}} and is not chainable. The typical use case is to execute side effects at the end of a chain.</p> - -<p><code>forEach()</code> does not mutate the array on which it is called (although <code>callback</code>, if invoked, may do so).</p> - -<div class="note"> -<p>There is no way to stop or break a <code>forEach()</code> loop other than by throwing an exception. If you need such behavior, the <code>forEach()</code> method is the wrong tool.</p> - -<p>Early termination may be accomplished with:</p> - -<ul> - <li>A simple loop</li> - <li>A <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for...of">for...of</a> loop</li> - <li>{{jsxref("Array.prototype.every()")}}</li> - <li>{{jsxref("Array.prototype.some()")}}</li> - <li>{{jsxref("Array.prototype.find()")}}</li> - <li>{{jsxref("Array.prototype.findIndex()")}}</li> -</ul> - -<p>The other Array methods: {{jsxref("Array.prototype.every()", "every()")}}, {{jsxref("Array.prototype.some()", "some()")}}, {{jsxref("Array.prototype.find()", "find()")}}, and {{jsxref("Array.prototype.findIndex()", "findIndex()")}} test the array elements with a predicate returning a truthy value to determine if further iteration is required.</p> -</div> - -<h2 id="Examples">Examples</h2> - -<h3 id="Converting_a_for_loop_to_forEach">Converting a for loop to forEach</h3> - -<p>before</p> - -<pre class="brush:js">const items = ['item1', 'item2', 'item3']; -const copy = []; - -for (let i=0; i<items.length; i++) { - copy.push(items[i]) -} -</pre> - -<p>after</p> - -<pre class="brush:js">const items = ['item1', 'item2', 'item3']; -const copy = []; - -items.forEach(function(item){ - copy.push(item) -}); - -</pre> - -<p> </p> - -<h3 id="Printing_the_contents_of_an_Array_Object">Printing the contents of an Array Object</h3> - -<p>The following code logs a line for each element in an array:</p> - -<pre class="brush:js">var userInfo = [{ - name: "Mayank", - age: 30 -}, { - name: Meha, - age: 26 -}]; - -userInfo.forEach(function(employee) { - console.log(employee.name) -}); -</pre> - -<p> </p> - -<p> </p> - -<p> </p> - -<h3 id="Printing_the_contents_of_an_array">Printing the contents of an array</h3> - -<p>The following code logs a line for each element in an array:</p> - -<pre class="brush:js">function logArrayElements(element, index, array) { - console.log('a[' + index + '] = ' + element); -} - -// Notice that index 2 is skipped since there is no item at -// that position in the array. -[2, 5, , 9].forEach(logArrayElements); -// logs: -// a[0] = 2 -// a[1] = 5 -// a[3] = 9 -</pre> - -<h3 id="Using_thisArg">Using <code>thisArg</code></h3> - -<p>The following (contrived) example updates an object's properties from each entry in the array:</p> - -<pre class="brush:js">function Counter() { - this.sum = 0; - this.count = 0; -} -Counter.prototype.add = function(array) { - array.forEach(function(entry) { - this.sum += entry; - ++this.count; - }, this); - // ^---- Note -}; - -const obj = new Counter(); -obj.add([2, 5, 9]); -obj.count; -// 3 -obj.sum; -// 16 -</pre> - -<p>Since the <code>thisArg</code> parameter (<code>this</code>) is provided to <code>forEach()</code>, it is passed to <code>callback</code> each time it's invoked, for use as its <code>this</code> value.</p> - -<div class="note"> -<p>If passing the function argument using an <a href="/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions">arrow function expression</a> the <code>thisArg</code> parameter can be omitted as arrow functions lexically bind the {{jsxref("Operators/this", "this")}} value.</p> -</div> - -<h3 id="An_object_copy_function">An object copy function</h3> - -<p>The following code creates a copy of a given object. There are different ways to create a copy of an object; the following is just one way and is presented to explain how <code>Array.prototype.forEach()</code> works by using ECMAScript 5 <code>Object.*</code> meta property functions.</p> - -<pre class="brush: js">function copy(obj) { - const copy = Object.create(Object.getPrototypeOf(obj)); - const propNames = Object.getOwnPropertyNames(obj); - - propNames.forEach(function(name) { - const desc = Object.getOwnPropertyDescriptor(obj, name); - Object.defineProperty(copy, name, desc); - }); - - return copy; -} - -const obj1 = { a: 1, b: 2 }; -const obj2 = copy(obj1); // obj2 looks like obj1 now -</pre> - -<h3 id="If_the_array_is_modified_during_iteration_other_elements_might_be_skipped.">If the array is modified during iteration, other elements might be skipped.</h3> - -<p>The following example logs "one", "two", "four". When the entry containing the value "two" is reached, the first entry of the whole array is shifted off, which results in all remaining entries moving up one position. Because element "four" is now at an earlier position in the array, "three" will be skipped. <code>forEach()</code> does not make a copy of the array before iterating.</p> - -<pre class="brush:js">var words = ['one', 'two', 'three', 'four']; -words.forEach(function(word) { - console.log(word); - if (word === 'two') { - words.shift(); - } -}); -// one -// two -// four -</pre> - -<h2 id="Polyfill">Polyfill</h2> - -<p><code>forEach()</code> was added to the ECMA-262 standard in the 5th edition; as such it may not be present in other implementations of the standard. You can work around this by inserting the following code at the beginning of your scripts, allowing use of <code>forEach()</code> in implementations that don't natively support it. This algorithm is exactly the one specified in ECMA-262, 5th edition, assuming {{jsxref("Object")}} and {{jsxref("TypeError")}} have their original values and that <code>callback.call()</code> evaluates to the original value of {{jsxref("Function.prototype.call()")}}.</p> - -<pre class="brush: js">// Production steps of ECMA-262, Edition 5, 15.4.4.18 -// Reference: http://es5.github.io/#x15.4.4.18 -if (!Array.prototype.forEach) { - - Array.prototype.forEach = function(callback/*, thisArg*/) { - - var T, k; - - if (this == null) { - throw new TypeError('this is null or not defined'); - } - - // 1. Let O be the result of calling toObject() passing the - // |this| value as the argument. - var O = Object(this); - - // 2. Let lenValue be the result of calling the Get() internal - // method of O with the argument "length". - // 3. Let len be toUint32(lenValue). - var len = O.length >>> 0; - - // 4. If isCallable(callback) is false, throw a TypeError exception. - // See: http://es5.github.com/#x9.11 - if (typeof callback !== 'function') { - throw new TypeError(callback + ' is not a function'); - } - - // 5. If thisArg was supplied, let T be thisArg; else let - // T be undefined. - if (arguments.length > 1) { - T = arguments[1]; - } - - // 6. Let k be 0. - k = 0; - - // 7. Repeat while k < len. - while (k < len) { - - var kValue; - - // a. Let Pk be ToString(k). - // This is implicit for LHS operands of the in operator. - // b. Let kPresent be the result of calling the HasProperty - // internal method of O with argument Pk. - // This step can be combined with c. - // c. If kPresent is true, then - if (k in O) { - - // i. Let kValue be the result of calling the Get internal - // method of O with argument Pk. - kValue = O[k]; - - // ii. Call the Call internal method of callback with T as - // the this value and argument list containing kValue, k, and O. - callback.call(T, kValue, k, O); - } - // d. Increase k by 1. - k++; - } - // 8. return undefined. - }; -} -</pre> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.4.4.18', 'Array.prototype.forEach')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Initial definition. Implemented in JavaScript 1.6.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-array.prototype.foreach', 'Array.prototype.forEach')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-array.prototype.foreach', 'Array.prototype.forEach')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<div> - - -<p>{{Compat("javascript.builtins.Array.forEach")}}</p> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("Array.prototype.find()")}}</li> - <li>{{jsxref("Array.prototype.findIndex()")}}</li> - <li>{{jsxref("Array.prototype.map()")}}</li> - <li>{{jsxref("Array.prototype.every()")}}</li> - <li>{{jsxref("Array.prototype.some()")}}</li> - <li>{{jsxref("Map.prototype.forEach()")}}</li> - <li>{{jsxref("Set.prototype.forEach()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/array/includes/index.html b/files/pt-pt/web/javascript/reference/global_objects/array/includes/index.html deleted file mode 100644 index 201d4c9526..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/array/includes/index.html +++ /dev/null @@ -1,175 +0,0 @@ ---- -title: Array.prototype.includes() -slug: Web/JavaScript/Reference/Global_Objects/Array/includes -tags: - - Array - - JavaScript - - Method - - Prototype - - Reference - - polyfill -translation_of: Web/JavaScript/Reference/Global_Objects/Array/includes ---- -<div>{{JSRef}}</div> - -<p>O método <code><strong>includes()</strong></code> determina se um array contém um determinado elemento, devolvendo <code>true</code> ou <code>false</code>. É utilizado o algoritmo sameValueZero para determinar se o elemento especificado foi encontrado.</p> - -<div>{{EmbedInteractiveExample("pages/js/array-includes.html")}}</div> - - - -<h2 id="Syntax">Syntax</h2> - -<pre class="syntaxbox"><var>arr</var>.includes(<var>searchElement[</var>, <var>fromIndex]</var>) -</pre> - -<h3 id="Parameters">Parameters</h3> - -<dl> - <dt><code>searchElement</code></dt> - <dd>The element to search for.</dd> - <dt><code>fromIndex</code> {{optional_inline}}</dt> - <dd>The position in this array at which to begin searching for <code>searchElement</code>. A negative value searches from the index of <code>array.length - fromIndex</code> by asc. Defaults to 0.</dd> -</dl> - -<h3 id="Return_value">Return value</h3> - -<p>A {{jsxref("Boolean")}}.</p> - -<h2 id="Examples">Examples</h2> - -<pre class="brush: js">[1, 2, 3].includes(2); // true -[1, 2, 3].includes(4); // false -[1, 2, 3].includes(3, 3); // false -[1, 2, 3].includes(3, -1); // true -[1, 2, NaN].includes(NaN); // true -</pre> - -<h3 id="fromIndex_is_greater_than_or_equal_to_the_array_length"><code>fromIndex</code> is greater than or equal to the array length</h3> - -<p>If <code>fromIndex</code> is greater than or equal to the length of the array, <code>false</code> is returned. The array will not be searched.</p> - -<pre class="brush: js">var arr = ['a', 'b', 'c']; - -arr.includes('c', 3); // false -arr.includes('c', 100); // false</pre> - -<h3 id="Computed_index_is_less_than_0">Computed index is less than 0</h3> - -<p>If <code>fromIndex</code> is negative, the computed index is calculated to be used as a position in the array at which to begin searching for <code>searchElement</code>. If the computed index is less than 0, the entire array will be searched.</p> - -<pre class="brush: js">// array length is 3 -// fromIndex is -100 -// computed index is 3 + (-100) = -97 - -var arr = ['a', 'b', 'c']; - -arr.includes('a', -100); // true -arr.includes('b', -100); // true -arr.includes('c', -100); // true</pre> - -<h3 id="includes()_used_as_a_generic_method"><code>includes()</code> used as a generic method</h3> - -<p><code>includes()</code> method is intentionally generic. It does not require <code>this</code> value to be an Array object, so it can be applied to other kinds of objects (e.g. array-like objects). The example below illustrates <code>includes()</code> method called on the function's <a href="/en-US/docs/Web/JavaScript/Reference/Functions/arguments">arguments</a> object.</p> - -<pre class="brush: js">(function() { - console.log([].includes.call(arguments, 'a')); // true - console.log([].includes.call(arguments, 'd')); // false -})('a','b','c');</pre> - -<h2 id="Polyfill">Polyfill</h2> - -<pre class="brush: js">// https://tc39.github.io/ecma262/#sec-array.prototype.includes -if (!Array.prototype.includes) { - Object.defineProperty(Array.prototype, 'includes', { - value: function(searchElement, fromIndex) { - - if (this == null) { - throw new TypeError('"this" is null or not defined'); - } - - // 1. Let O be ? ToObject(this value). - var o = Object(this); - - // 2. Let len be ? ToLength(? Get(O, "length")). - var len = o.length >>> 0; - - // 3. If len is 0, return false. - if (len === 0) { - return false; - } - - // 4. Let n be ? ToInteger(fromIndex). - // (If fromIndex is undefined, this step produces the value 0.) - var n = fromIndex | 0; - - // 5. If n ≥ 0, then - // a. Let k be n. - // 6. Else n < 0, - // a. Let k be len + n. - // b. If k < 0, let k be 0. - var k = Math.max(n >= 0 ? n : len - Math.abs(n), 0); - - function sameValueZero(x, y) { - return x === y || (typeof x === 'number' && typeof y === 'number' && isNaN(x) && isNaN(y)); - } - - // 7. Repeat, while k < len - while (k < len) { - // a. Let elementK be the result of ? Get(O, ! ToString(k)). - // b. If SameValueZero(searchElement, elementK) is true, return true. - if (sameValueZero(o[k], searchElement)) { - return true; - } - // c. Increase k by 1. - k++; - } - - // 8. Return false - return false; - } - }); -} -</pre> - -<p>If you need to support truly obsolete JavaScript engines that don't support <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty">Object.defineProperty</a></code>, it's best not to polyfill <code>Array.prototype</code> methods at all, as you can't make them non-enumerable.</p> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES7', '#sec-array.prototype.includes', 'Array.prototype.includes')}}</td> - <td>{{Spec2('ES7')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-array.prototype.includes', 'Array.prototype.includes')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<div> - - -<p>{{Compat("javascript.builtins.Array.includes")}}</p> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("TypedArray.prototype.includes()")}}</li> - <li>{{jsxref("String.prototype.includes()")}}</li> - <li>{{jsxref("Array.prototype.indexOf()")}}</li> - <li>{{jsxref("Array.prototype.find()")}}</li> - <li>{{jsxref("Array.prototype.findIndex()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/array/index.html b/files/pt-pt/web/javascript/reference/global_objects/array/index.html deleted file mode 100644 index 5f26f41549..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/array/index.html +++ /dev/null @@ -1,440 +0,0 @@ ---- -title: Array -slug: Web/JavaScript/Reference/Global_Objects/Array -tags: - - Array - - Class - - Exemplo - - Global Objects - - JavaScript - - Referencia - - 'l10n:priority' -translation_of: Web/JavaScript/Reference/Global_Objects/Array ---- -<div>{{JSRef}}</div> - -<p>A classe de JavaScript <strong><code>Array</code></strong> é um objecto global que é utilizado na construção de matrizes; que são objectos de alto nível, semelhantes a listas.</p> - -<h2 id="Descrição">Descrição</h2> - -<p>Arrays são objectos em forma de lista, cujo protótipo tem métodos para realizar operações de travessia e mutação. Nem o comprimento de uma array JavaScript nem os tipos dos seus elementos são fixos. Uma vez que o comprimento de uma array pode mudar a qualquer momento, e os dados podem ser armazenados em locais não contíguos da array, não é garantido que uma array JavaScript seja densa; isto depende de como o programador opta por usá-las. Em geral, estas são características convenientes; mas se estas características não forem desejáveis para seu uso particular, você pode considerar o uso de arrays tipadas.</p> - -<p>Uma array não pode utilizar strings como índices de elementos (como num {{InterWiki("wikipedia", "Vetor_associativo", "array associativa")}}), deve utilizar números inteiros. A definição ou acesso através de não-inteiros usando notação de parênteses (ou notação de pontos) não definirá ou recuperará um elemento da própria lista da array, mas definirá ou acessará uma variável associada à <a href="pt-PT/docs/Web/JavaScript/Estruturas_de_dados#Objetos">coleção de propriedades dessa array</a>. As propriedades da array e a lista de elementos do mesmo são separadas, e as operações de translação e mutação da array não podem ser aplicadas a essas propriedades com nome.</p> - -<p><strong>Criar uma Array</strong></p> - -<pre class="brush: js notranslate">var fruits = ['Apple', 'Banana']; - -console.log(fruits.length); -// 2 -</pre> - -<p><strong>Aceder (através de índice) item<span class="original-content"> da </span>Array</strong></p> - -<pre class="brush: js notranslate">var first = fruits[0]; -// Apple - -var last = fruits[fruits.length - 1]; -// Banana -</pre> - -<p><strong>Loop over an Array</strong></p> - -<pre class="brush: js notranslate">fruits.forEach(function(item, index, array) { - console.log(item, index); -}); -// Apple 0 -// Banana 1 -</pre> - -<p><strong>Adicionar um item ao fim da Array</strong></p> - -<pre class="brush: js notranslate">var newLength = fruits.push('Orange'); -// ["Apple", "Banana", "Orange"] -</pre> - -<p><strong>Remover um item do fim da Array</strong></p> - -<pre class="brush: js notranslate">var last = fruits.pop(); // remove Orange (from the end) -// ["Apple", "Banana"]; -</pre> - -<p><strong>Remover um item do início da Array</strong></p> - -<pre class="brush: js notranslate">var first = fruits.shift(); // remove Apple from the front -// ["Banana"]; -</pre> - -<p><strong>Ad</strong><strong>icionar um item ao início da Array</strong></p> - -<pre class="brush: js notranslate">var newLength = fruits.unshift('Strawberry') // add to the front -// ["Strawberry", "Banana"]; -</pre> - -<p><strong>Encontrar o índice dum item na Array</strong></p> - -<pre class="brush: js notranslate">fruits.push('Mango'); -// ["Strawberry", "Banana", "Mango"] - -var pos = fruits.indexOf('Banana'); -// 1 -</pre> - -<p><strong>Remover um item pela posição do índice</strong></p> - -<pre class="brush: js notranslate">var removedItem = fruits.splice(pos, 1); // this is how to remove an item - -// ["Strawberry", "Mango"]</pre> - -<p><strong>Remover items pela posição do índice</strong></p> - -<pre class="brush: js notranslate">var vegetables = ['Cabbage', 'Turnip', 'Radish', 'Carrot']; -console.log(vegetables); -// ["Cabbage", "Turnip", "Radish", "Carrot"] - -var pos = 1, n = 2; - -var removedItems = vegetables.splice(pos, n); -// this is how to remove items, n defines the number of items to be removed, -// from that position(pos) onward to the end of array. - -console.log(vegetables); -// ["Cabbage", "Carrot"] (the original array is changed) - -console.log(removedItems); -// ["Turnip", "Radish"]</pre> - -<p><strong>Copiar uma Array</strong></p> - -<pre class="brush: js notranslate">var shallowCopy = fruits.slice(); // this is how to make a copy -// ["Strawberry"] -</pre> - -<h3 id="Como_aceder_a_elementos_da_array">Como aceder a elementos da array</h3> - -<p>JavaScript arrays are zero-indexed: the first element of an array is at index <code>0</code>, and the last element is at the index equal to the value of the array's {{jsxref("Array.length", "length")}} property minus 1.</p> - -<pre class="brush: js notranslate">var arr = ['this is the first element', 'this is the second element']; -console.log(arr[0]); // logs 'this is the first element' -console.log(arr[1]); // logs 'this is the second element' -console.log(arr[arr.length - 1]); // logs 'this is the second element' -</pre> - -<p>Array elements are object properties in the same way that <code>toString</code> is a property, but trying to access an element of an array as follows throws a syntax error, because the property name is not valid:</p> - -<pre class="brush: js notranslate">console.log(arr.0); // a syntax error -</pre> - -<p>There is nothing special about JavaScript arrays and the properties that cause this. JavaScript properties that begin with a digit cannot be referenced with dot notation; and must be accessed using bracket notation. For example, if you had an object with a property named <code>'3d'</code>, it can only be referenced using bracket notation. E.g.:</p> - -<pre class="brush: js notranslate">var years = [1950, 1960, 1970, 1980, 1990, 2000, 2010]; -console.log(years.0); // a syntax error -console.log(years[0]); // works properly -</pre> - -<pre class="brush: js notranslate">renderer.3d.setTexture(model, 'character.png'); // a syntax error -renderer['3d'].setTexture(model, 'character.png'); // works properly -</pre> - -<p>Note that in the <code>3d</code> example, <code>'3d'</code> had to be quoted. It's possible to quote the JavaScript array indexes as well (e.g., <code>years['2']</code> instead of <code>years[2]</code>), although it's not necessary. The 2 in <code>years[2]</code> is coerced into a string by the JavaScript engine through an implicit <code>toString</code> conversion. It is for this reason that <code>'2'</code> and <code>'02'</code> would refer to two different slots on the <code>years</code> object and the following example could be <code>true</code>:</p> - -<pre class="brush: js notranslate">console.log(years['2'] != years['02']); -</pre> - -<p>Similarly, object properties which happen to be reserved words(!) can only be accessed as string literals in bracket notation(but it can be accessed by dot notation in firefox 40.0a2 at least):</p> - -<pre class="brush: js notranslate">var promise = { - 'var' : 'text', - 'array': [1, 2, 3, 4] -}; - -console.log(promise['var']); -</pre> - -<h3 id="Relationship_between_length_and_numerical_properties">Relationship between <code>length</code> and numerical properties</h3> - -<p>A JavaScript array's {{jsxref("Array.length", "length")}} property and numerical properties are connected. Several of the built-in array methods (e.g., {{jsxref("Array.join", "join")}}, {{jsxref("Array.slice", "slice")}}, {{jsxref("Array.indexOf", "indexOf")}}, etc.) take into account the value of an array's {{jsxref("Array.length", "length")}} property when they're called. Other methods (e.g., {{jsxref("Array.push", "push")}}, {{jsxref("Array.splice", "splice")}}, etc.) also result in updates to an array's {{jsxref("Array.length", "length")}} property.</p> - -<pre class="brush: js notranslate">var fruits = []; -fruits.push('banana', 'apple', 'peach'); - -console.log(fruits.length); // 3 -</pre> - -<p>When setting a property on a JavaScript array when the property is a valid array index and that index is outside the current bounds of the array, the engine will update the array's {{jsxref("Array.length", "length")}} property accordingly:</p> - -<pre class="brush: js notranslate">fruits[5] = 'mango'; -console.log(fruits[5]); // 'mango' -console.log(Object.keys(fruits)); // ['0', '1', '2', '5'] -console.log(fruits.length); // 6 -</pre> - -<p>Increasing the {{jsxref("Array.length", "length")}}.</p> - -<pre class="brush: js notranslate">fruits.length = 10; -console.log(Object.keys(fruits)); // ['0', '1', '2', '5'] -console.log(fruits.length); // 10 -</pre> - -<p>Decreasing the {{jsxref("Array.length", "length")}} property does, however, delete elements.</p> - -<pre class="brush: js notranslate">fruits.length = 2; -console.log(Object.keys(fruits)); // ['0', '1'] -console.log(fruits.length); // 2 -</pre> - -<p>This is explained further on the {{jsxref("Array.length")}} page.</p> - -<h3 id="Creating_an_array_using_the_result_of_a_match">Creating an array using the result of a match</h3> - -<p>The result of a match between a regular expression and a string can create a JavaScript array. This array has properties and elements which provide information about the match. Such an array is returned by {{jsxref("RegExp.exec")}}, {{jsxref("String.match")}}, and {{jsxref("String.replace")}}. To help explain these properties and elements, look at the following example and then refer to the table below:</p> - -<pre class="brush: js notranslate">// Match one d followed by one or more b's followed by one d -// Remember matched b's and the following d -// Ignore case - -var myRe = /d(b+)(d)/i; -var myArray = myRe.exec('cdbBdbsbz'); -</pre> - -<p>The properties and elements returned from this match are as follows:</p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <td class="header">Property/Element</td> - <td class="header">Description</td> - <td class="header">Example</td> - </tr> - <tr> - <td><code>input</code></td> - <td>A read-only property that reflects the original string against which the regular expression was matched.</td> - <td>cdbBdbsbz</td> - </tr> - <tr> - <td><code>index</code></td> - <td>A read-only property that is the zero-based index of the match in the string.</td> - <td>1</td> - </tr> - <tr> - <td><code>[0]</code></td> - <td>A read-only element that specifies the last matched characters.</td> - <td>dbBd</td> - </tr> - <tr> - <td><code>[1], ...[n]</code></td> - <td>Read-only elements that specify the parenthesized substring matches, if included in the regular expression. The number of possible parenthesized substrings is unlimited.</td> - <td>[1]: bB<br> - [2]: d</td> - </tr> - </tbody> -</table> - -<h2 id="Properties">Properties</h2> - -<dl> - <dt><code>Array.length</code></dt> - <dd>The <code>Array</code> constructor's length property whose value is 1.</dd> - <dt>{{jsxref("Array.@@species", "get Array[@@species]")}}</dt> - <dd>The constructor function that is used to create derived objects.</dd> - <dt>{{jsxref("Array.prototype")}}</dt> - <dd>Allows the addition of properties to all array objects.</dd> -</dl> - -<h2 id="Methods">Methods</h2> - -<dl> - <dt>{{jsxref("Array.from()")}}</dt> - <dd>Creates a new <code>Array</code> instance from an array-like or iterable object.</dd> - <dt>{{jsxref("Array.isArray()")}}</dt> - <dd>Returns true if a variable is an array, if not false.</dd> - <dt>{{jsxref("Array.of()")}}</dt> - <dd>Creates a new <code>Array</code> instance with a variable number of arguments, regardless of number or type of the arguments.</dd> -</dl> - -<h2 id="Array_instances"><code>Array</code> instances</h2> - -<p>All <code>Array</code> instances inherit from {{jsxref("Array.prototype")}}. The prototype object of the <code>Array</code> constructor can be modified to affect all <code>Array</code> instances.</p> - -<h3 id="Properties_2">Properties</h3> - -<div>{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/prototype', 'Properties')}}</div> - -<h3 id="Methods_2">Methods</h3> - -<h4 id="Mutator_methods">Mutator methods</h4> - -<div>{{page('en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/prototype', 'Mutator_methods')}}</div> - -<h4 id="Accessor_methods">Accessor methods</h4> - -<div>{{page('en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/prototype', 'Accessor_methods')}}</div> - -<h4 id="Iteration_methods">Iteration methods</h4> - -<div>{{page('en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/prototype', 'Iteration_methods')}}</div> - -<h2 id="Array_generic_methods"><code>Array</code> generic methods</h2> - -<div class="warning"> -<p><strong>Array generics are non-standard, deprecated and will get removed in the near future</strong>. </p> -</div> - -<p>Sometimes you would like to apply array methods to strings or other array-like objects (such as function {{jsxref("Functions/arguments", "arguments", "", 1)}}). By doing this, you treat a string as an array of characters (or otherwise treat a non-array as an array). For example, in order to check that every character in the variable <var>str</var> is a letter, you would write:</p> - -<pre class="brush: js notranslate">function isLetter(character) { - return character >= 'a' && character <= 'z'; -} - -if (Array.prototype.every.call(str, isLetter)) { - console.log("The string '" + str + "' contains only letters!"); -} -</pre> - -<p>This notation is rather wasteful and JavaScript 1.6 introduced a generic shorthand:</p> - -<pre class="brush: js notranslate">if (Array.every(str, isLetter)) { - console.log("The string '" + str + "' contains only letters!"); -} -</pre> - -<p>{{jsxref("Global_Objects/String", "Generics", "#String_generic_methods", 1)}} are also available on {{jsxref("String")}}.</p> - -<p>These are <strong>not</strong> part of ECMAScript standards and they are not supported by non-Gecko browsers. As a standard alternative, you can convert your object to a proper array using {{jsxref("Array.from()")}}; although that method may not be supported in old browsers:</p> - -<pre class="brush: js notranslate">if (Array.from(str).every(isLetter)) { - console.log("The string '" + str + "' contains only letters!"); -} -</pre> - -<h2 id="Examples">Examples</h2> - -<h3 id="Creating_an_array">Creating an array</h3> - -<p>The following example creates an array, <code>msgArray</code>, with a length of 0, then assigns values to <code>msgArray[0]</code> and <code>msgArray[99]</code>, changing the length of the array to 100.</p> - -<pre class="brush: js notranslate">var msgArray = []; -msgArray[0] = 'Hello'; -msgArray[99] = 'world'; - -if (msgArray.length === 100) { - console.log('The length is 100.'); -} -</pre> - -<h3 id="Creating_a_two-dimensional_array">Creating a two-dimensional array</h3> - -<p>The following creates a chess board as a two dimensional array of strings. The first move is made by copying the 'p' in (6,4) to (4,4). The old position (6,4) is made blank.</p> - -<pre class="brush: js notranslate">var board = [ - ['R','N','B','Q','K','B','N','R'], - ['P','P','P','P','P','P','P','P'], - [' ',' ',' ',' ',' ',' ',' ',' '], - [' ',' ',' ',' ',' ',' ',' ',' '], - [' ',' ',' ',' ',' ',' ',' ',' '], - [' ',' ',' ',' ',' ',' ',' ',' '], - ['p','p','p','p','p','p','p','p'], - ['r','n','b','q','k','b','n','r'] ]; - -console.log(board.join('\n') + '\n\n'); - -// Move King's Pawn forward 2 -board[4][4] = board[6][4]; -board[6][4] = ' '; -console.log(board.join('\n')); -</pre> - -<p>Here is the output:</p> - -<pre class="eval notranslate">R,N,B,Q,K,B,N,R -P,P,P,P,P,P,P,P - , , , , , , , - , , , , , , , - , , , , , , , - , , , , , , , -p,p,p,p,p,p,p,p -r,n,b,q,k,b,n,r - -R,N,B,Q,K,B,N,R -P,P,P,P,P,P,P,P - , , , , , , , - , , , , , , , - , , , ,p, , , - , , , , , , , -p,p,p,p, ,p,p,p -r,n,b,q,k,b,n,r -</pre> - -<h3 id="Using_an_array_to_tabulate_a_set_of_values">Using an array to tabulate a set of values</h3> - -<pre class="brush: js notranslate">values = []; -for (var x = 0; x < 10; x++){ - values.push([ - 2 ** x, - 2 * x ** 2 - ]) -}; -console.table(values)</pre> - -<p>Results in</p> - -<pre class="eval notranslate">0 1 0 -1 2 2 -2 4 8 -3 8 18 -4 16 32 -5 32 50 -6 64 72 -7 128 98 -8 256 128 -9 512 162</pre> - -<p>(First column is the (index))</p> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.4', 'Array')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>New methods added: {{jsxref("Array.isArray")}}, {{jsxref("Array.prototype.indexOf", "indexOf")}}, {{jsxref("Array.prototype.lastIndexOf", "lastIndexOf")}}, {{jsxref("Array.prototype.every", "every")}}, {{jsxref("Array.prototype.some", "some")}}, {{jsxref("Array.prototype.forEach", "forEach")}}, {{jsxref("Array.prototype.map", "map")}}, {{jsxref("Array.prototype.filter", "filter")}}, {{jsxref("Array.prototype.reduce", "reduce")}}, {{jsxref("Array.prototype.reduceRight", "reduceRight")}}</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-array-objects', 'Array')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>New methods added: {{jsxref("Array.from")}}, {{jsxref("Array.of")}}, {{jsxref("Array.prototype.find", "find")}}, {{jsxref("Array.prototype.findIndex", "findIndex")}}, {{jsxref("Array.prototype.fill", "fill")}}, {{jsxref("Array.prototype.copyWithin", "copyWithin")}}</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-array-objects', 'Array')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>New method added: {{jsxref("Array.prototype.includes()")}}</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_Navegadores">Compatibilidade de Navegadores</h2> - -<div class="hidden">A tabela de compatibilidade nesta página é gerada a partir de dados estruturados. Se quiser contribuir para os dados, por favor consulte <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> e envie-nos um pull request.</div> - -<p>{{Compat("javascript.builtins.Array")}}</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Guide/Working_with_Objects#Indexing_object_properties">JavaScript Guide: “Indexing object properties”</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Guide/Predefined_Core_Objects#Array_Object">JavaScript Guide: “Predefined Core Objects: <code>Array</code> Object”</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Array_comprehensions">Array comprehensions</a></li> - <li><a href="https://github.com/plusdude/array-generics">Polyfill for JavaScript 1.8.5 Array Generics and ECMAScript 5 Array Extras</a></li> - <li><a href="/en-US/docs/JavaScript_typed_arrays">Typed Arrays</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/array/join/index.html b/files/pt-pt/web/javascript/reference/global_objects/array/join/index.html deleted file mode 100644 index aec6f34cc2..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/array/join/index.html +++ /dev/null @@ -1,90 +0,0 @@ ---- -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> diff --git a/files/pt-pt/web/javascript/reference/global_objects/array/map/index.html b/files/pt-pt/web/javascript/reference/global_objects/array/map/index.html deleted file mode 100644 index 12910ebc2a..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/array/map/index.html +++ /dev/null @@ -1,366 +0,0 @@ ---- -title: Array.prototype.map() -slug: Web/JavaScript/Reference/Global_Objects/Array/map -tags: - - Array - - ECMAScript 5 - - JavaScript - - Prototype - - Referencia - - metodo - - polyfill -translation_of: Web/JavaScript/Reference/Global_Objects/Array/map ---- -<div>{{JSRef}}</div> - -<p><span class="seoSummary">O método <code><strong>map()</strong></code> <strong>cria uma nova array</strong> preenchida com os resultados da chamada de uma função fornecida em cada elemento da matriz de chamada.</span></p> - -<div>{{EmbedInteractiveExample("pages/js/array-map.html")}}</div> - -<div class="hidden">The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> and send us a pull request.</div> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox notranslate">let <var>new_array</var> = <var>arr</var>.map(function <var>callback</var>( <var>currentValue</var>[, <var>index</var>[, <var>array</var>]]) { - // retorna novo elemento para new_array -}[, <var>thisArg</var>]) -</pre> - -<h3 id="Parameteros">Parameteros</h3> - -<dl> - <dt><code><var>callback</var></code></dt> - <dd> - <p>Função que é chamada para cada elemento de <code>arr</code>. Cada vez que a função <code>callback</code> é executada, o valor devolvido é acrescentado a <code>new_array</code>.</p> - - <p>A função <code><var>callback</var></code> aceita os seguintes argumentos:</p> - - <dl> - <dt><code><var>currentValue</var></code></dt> - <dd>O elemento da matriz a ser processado.</dd> - <dt><code><var>index</var></code>{{optional_inline}}</dt> - <dd>O indice do elemento da matriz a ser processado.</dd> - <dt><code><var>array</var></code>{{optional_inline}}</dt> - <dd>A matriz em que a função <code>map</code> foi chamada.</dd> - </dl> - </dd> - <dt><code>thisArg</code>{{optional_inline}}</dt> - <dd>Valor para usar como <code>this</code> ao executar a função <code><var>callback</var></code>.</dd> -</dl> - -<h3 id="Valor_de_retorno">Valor de retorno</h3> - -<p>Uma nova matriz em que cada elemento é um resultado da função callback..</p> - -<h2 id="Descrição">Descrição</h2> - -<p><code>map</code> chama a função <code><var>callback</var></code> <strong>uma vez por cada elemento</strong> na matriz, por ordem, e cria uma matriz com os resultados. <code><var>callback</var></code> é só chamada nos indices da matriz que têm valores (inclusive {{jsxref("undefined")}}).</p> - -<p>Não é chamada para elementos que não pertecem à matriz; isto sendo:</p> - -<ul> - <li>indices que não pertencem pela matriz;</li> - <li>que foram eliminados; ou</li> - <li>que nunca tiveram um valor.</li> -</ul> - -<h3 id="Quando_não_usar_map">Quando não usar map()</h3> - -<p>Como <code>map</code> map cira uma nova matriz, é um <em>anti-pattern</em> usar a função quando não se vai usar o valor devolvido; use antes {{jsxref("Array/forEach", "forEach")}} ou {{jsxref("for...of", "for-of")}}.</p> - -<p>Não deve usar <code>map</code> se:</p> - -<ul> - <li>não vai usar o valor devolvido; e/ou</li> - <li>o <code>callback</code> não devolve um valor.</li> -</ul> - -<h3 id="Parameteros_em_detalhe">Parameteros em detalhe</h3> - -<p><code><var>callback</var></code> é chamada com três argumentos: o valor do elemento, o indice do elemento, e a matriz do objeto a ser mapeado.</p> - -<p>Se o parametero <code>thisArg</code> é fornecido, é usado como o valor de <code>this</code> na função <em><code>callback</code></em>. Se não, o valor {{jsxref("undefined")}} é usado como o valor de <code>this</code>. O valor de <code>this</code> no corpo da função <code><var>callback</var></code> é determinado de acordo com <a href="/en-US/docs/Web/JavaScript/Reference/Operators/this">as regras habituais para determinar o valor de this numa função</a>.</p> - -<p><code>map</code> não modifica a matriz em que é chamada (embora a função <em><code>callback</code></em>, se invocada, possa fazê-lo).</p> - -<p>A série de elementos processados por <code>map</code> é definida antes da primeira invocação de <em><code>callback</code></em>. Os elementos que são anexados ao conjunto após a chamada para <code>map</code> não serão visitados por <code><em>callback</em></code>. Se os elementos existentes da matriz forem alterados, o seu valor como passado para <em><code>callback</code></em> será o valor no momento em que <code>map</code> os visitar. Os elementos que são apagados após a chamada para <code>map</code> começa e antes de serem visitados, não são visitados.</p> - -<p>Devido ao algoritmo defenido na especificação, se a matriz em que <code>map</code> é chamada for esparsa, a matriz resultante também o será com os mesmos indices em branco.</p> - -<h2 id="Polyfill">Polyfill</h2> - -<p><code>map</code> was added to the ECMA-262 standard in the 5th edition. Therefore, it may not be present in all implementations of the standard.</p> - -<p>You can work around this by inserting the following code at the beginning of your scripts, allowing use of <code>map</code> in implementations which do not natively support it. This algorithm is exactly the one specified in ECMA-262, 5th edition, assuming {{jsxref("Object")}}, {{jsxref("TypeError")}}, and {{jsxref("Array")}} have their original values and that <code>callback.call</code> evaluates to the original value of <code>{{jsxref("Function.prototype.call")}}</code>.</p> - -<pre class="brush: js notranslate">// Production steps of ECMA-262, Edition 5, 15.4.4.19 -// Reference: http://es5.github.io/#x15.4.4.19 -if (!Array.prototype.map) { - - Array.prototype.map = function(callback/*, thisArg*/) { - - var T, A, k; - - if (this == null) { - throw new TypeError('this is null or not defined'); - } - - // 1. Let O be the result of calling ToObject passing the |this| - // value as the argument. - var O = Object(this); - - // 2. Let lenValue be the result of calling the Get internal - // method of O with the argument "length". - // 3. Let len be ToUint32(lenValue). - var len = O.length >>> 0; - - // 4. If IsCallable(callback) is false, throw a TypeError exception. - // See: http://es5.github.com/#x9.11 - if (typeof callback !== 'function') { - throw new TypeError(callback + ' is not a function'); - } - - // 5. If thisArg was supplied, let T be thisArg; else let T be undefined. - if (arguments.length > 1) { - T = arguments[1]; - } - - // 6. Let A be a new array created as if by the expression new Array(len) - // where Array is the standard built-in constructor with that name and - // len is the value of len. - A = new Array(len); - - // 7. Let k be 0 - k = 0; - - // 8. Repeat, while k < len - while (k < len) { - - var kValue, mappedValue; - - // a. Let Pk be ToString(k). - // This is implicit for LHS operands of the in operator - // b. Let kPresent be the result of calling the HasProperty internal - // method of O with argument Pk. - // This step can be combined with c - // c. If kPresent is true, then - if (k in O) { - - // i. Let kValue be the result of calling the Get internal - // method of O with argument Pk. - kValue = O[k]; - - // ii. Let mappedValue be the result of calling the Call internal - // method of callback with T as the this value and argument - // list containing kValue, k, and O. - mappedValue = callback.call(T, kValue, k, O); - - // iii. Call the DefineOwnProperty internal method of A with arguments - // Pk, Property Descriptor - // { Value: mappedValue, - // Writable: true, - // Enumerable: true, - // Configurable: true }, - // and false. - - // In browsers that support Object.defineProperty, use the following: - // Object.defineProperty(A, k, { - // value: mappedValue, - // writable: true, - // enumerable: true, - // configurable: true - // }); - - // For best browser support, use the following: - A[k] = mappedValue; - } - // d. Increase k by 1. - k++; - } - - // 9. return A - return A; - }; -} -</pre> - -<h2 id="Examples">Examples</h2> - -<h3 id="Mapping_an_array_of_numbers_to_an_array_of_square_roots">Mapping an array of numbers to an array of square roots</h3> - -<p>The following code takes an array of numbers and creates a new array containing the square roots of the numbers in the first array.</p> - -<pre class="brush: js notranslate">let numbers = [1, 4, 9] -let roots = numbers.map(function(num) { - return Math.sqrt(num) -}) -// roots is now [1, 2, 3] -// numbers is still [1, 4, 9] -</pre> - -<h3 id="Using_map_to_reformat_objects_in_an_array">Using map to reformat objects in an array</h3> - -<p>The following code takes an array of objects and creates a new array containing the newly reformatted objects.</p> - -<pre class="brush: js notranslate">let kvArray = [{key: 1, value: 10}, - {key: 2, value: 20}, - {key: 3, value: 30}] - -let reformattedArray = kvArray.map(obj => { - let rObj = {} - rObj[obj.key] = obj.value - return rObj -}) -// reformattedArray is now [{1: 10}, {2: 20}, {3: 30}], - -// kvArray is still: -// [{key: 1, value: 10}, -// {key: 2, value: 20}, -// {key: 3, value: 30}] -</pre> - -<h3 id="Mapping_an_array_of_numbers_using_a_function_containing_an_argument">Mapping an array of numbers using a function containing an argument</h3> - -<p>The following code shows how <code>map</code> works when a function requiring one argument is used with it. The argument will automatically be assigned from each element of the array as <code>map</code> loops through the original array.</p> - -<pre class="brush: js notranslate">let numbers = [1, 4, 9] -let doubles = numbers.map(function(num) { - return num * 2 -}) - -// doubles is now [2, 8, 18] -// numbers is still [1, 4, 9] -</pre> - -<h3 id="Using_map_generically">Using map generically</h3> - -<p>This example shows how to use map on a {{jsxref("String")}} to get an array of bytes in the ASCII encoding representing the character values:</p> - -<pre class="brush: js notranslate">let map = Array.prototype.map -let a = map.call('Hello World', function(x) { - return x.charCodeAt(0) -}) -// a now equals [72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100] -</pre> - -<h3 id="Using_map_generically_querySelectorAll">Using map generically querySelectorAll</h3> - -<p>This example shows how to iterate through a collection of objects collected by <code>querySelectorAll</code>. This is because <code>querySelectorAll</code> returns a <code>NodeList</code> (which is a collection of objects).</p> - -<p>In this case, we return all the selected <code>option</code>s' values on the screen:</p> - -<pre class="brush: js notranslate">let elems = document.querySelectorAll('select option:checked') -let values = Array.prototype.map.call(elems, function(obj) { - return obj.value -}) -</pre> - -<p>An easier way would be the {{jsxref("Array.from()")}} method.</p> - -<h3 id="Tricky_use_case">Tricky use case</h3> - -<p>(<a href="http://www.wirfs-brock.com/allen/posts/166">inspired by this blog post</a>)</p> - -<p>It is common to use the callback with one argument (the element being traversed). Certain functions are also commonly used with one argument, even though they take additional optional arguments. These habits may lead to confusing behaviors.</p> - -<p>Consider:</p> - -<pre class="brush: js notranslate">["1", "2", "3"].map(parseInt)</pre> - -<p>While one might expect <code>[1, 2, 3]</code>, the actual result is <code>[1, NaN, NaN]</code>.</p> - -<p>{{jsxref("parseInt")}} is often used with one argument, but takes two. The first is an expression and the second is the radix to the callback function, <code>Array.prototype.map</code> passes 3 arguments:</p> - -<ul> - <li>the element</li> - <li>the index</li> - <li>the array</li> -</ul> - -<p>The third argument is ignored by {{jsxref("parseInt")}}—but <em>not</em> the second one! This is the source of possible confusion.</p> - -<p>Here is a concise example of the iteration steps:</p> - -<pre class="brush: js notranslate">// parseInt(string, radix) -> map(parseInt(value, index)) -/* first iteration (index is 0): */ parseInt("1", 0) // 1 -/* second iteration (index is 1): */ parseInt("2", 1) // NaN -/* third iteration (index is 2): */ parseInt("3", 2) // NaN -</pre> - -<p>Then let's talk about solutions.</p> - -<pre class="brush: js notranslate">function returnInt(element) { - return parseInt(element, 10) -} - -['1', '2', '3'].map(returnInt); // [1, 2, 3] -// Actual result is an array of numbers (as expected) - -// Same as above, but using the concise arrow function syntax -['1', '2', '3'].map( str => parseInt(str) ) - -// A simpler way to achieve the above, while avoiding the "gotcha": -['1', '2', '3'].map(Number) // [1, 2, 3] - -// But unlike parseInt(), Number() will also return a float or (resolved) exponential notation: -['1.1', '2.2e2', '3e300'].map(Number) // [1.1, 220, 3e+300] - -// For comparison, if we use parseInt() on the array above: -['1.1', '2.2e2', '3e300'].map( str => parseInt(str) ) // [1, 2, 3] -</pre> - -<p>One alternative output of the map method being called with {{jsxref("parseInt")}} as a parameter runs as follows:</p> - -<pre class="brush: js notranslate">let xs = ['10', '10', '10'] - -xs = xs.map(parseInt) - -console.log(xs) -// Actual result of 10,NaN,2 may be unexpected based on the above description.</pre> - -<h3 id="Mapped_array_contains_undefined">Mapped array contains undefined</h3> - -<p>When {{jsxref("undefined")}} or nothing is returned:</p> - -<pre class="brush: js notranslate">let numbers = [1, 2, 3, 4] -let filteredNumbers = numbers.map(function(num, index) { - if (index < 3) { - return num - } -}) -// index goes from 0, so the filterNumbers are 1,2,3 and undefined. -// filteredNumbers is [1, 2, 3, undefined] -// numbers is still [1, 2, 3, 4] - -</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-array.prototype.map', 'Array.prototype.map')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - -<div> - - -<p>{{Compat("javascript.builtins.Array.map")}}</p> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{jsxref("Array.prototype.forEach()")}}</li> - <li>{{jsxref("Map")}} object</li> - <li>{{jsxref("Array.from()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/array/pop/index.html b/files/pt-pt/web/javascript/reference/global_objects/array/pop/index.html deleted file mode 100644 index 440ea3e6ee..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/array/pop/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: Array.prototype.pop() -slug: Web/JavaScript/Reference/Global_Objects/Array/pop -tags: - - JavaScript - - Lista - - Prototipo - - Referencia - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Array/pop ---- -<div>{{JSRef}}</div> - -<p>O método <code><strong>pop()</strong></code> remove o último elemento de um array e retorna esse elemento. Este método altera o tamanho do array.</p> - -<div>{{EmbedInteractiveExample("pages/js/array-pop.html")}}</div> - -<h2 id="Syntax">Syntax</h2> - -<pre class="syntaxbox"><var>arr</var>.pop()</pre> - -<h3 id="Valor_retornado">Valor retornado</h3> - -<p>O elemento removido do array; {{jsxref("undefined")}} se o array estiver vazio.</p> - -<h2 id="Descrição">Descrição</h2> - -<p>O método <code>pop</code> remove o último elemento de um array e retorna esse elemento para a função que o chamou.</p> - -<p><code>pop</code> é um método intencionalmente genérico; este método pode ser {{jsxref("Function.call", "called", "", 1)}} ou {{jsxref("Function.apply", "applied", "", 1)}} para objectos parecidos com arrays. Objectos que não contenham a propriedade <code>length</code> (tamanho) que reflete o último elemento numa lista de consecutivas propriedades numéricas zero-based, pode não se comportar de maneira significativa.</p> - -<p><code><font face="Open Sans, arial, x-locale-body, sans-serif"><span style="background-color: #ffffff;">Se o método </span></font>pop()</code> for chamado num array vazio este retorna {{jsxref("undefined")}}.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Remover_o_último_elemento_de_um_array">Remover o último elemento de um array</h3> - -<p>O seguinte exemplo cria um array <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">peixes</span></font> que contêm quatro elementos, e depois remove o último elemento.</p> - -<pre class="brush: js">var peixes = ['anjo', 'palhaço', 'mandarim', 'esturjão']; - -var popped = peixes.pop(); - -console.log(peixes); // ['anjo', 'palhaço', 'mandarim'] - -console.log(popped); // 'esturjão'</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Definição inicial. Implementada no JavaScript 1.2.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.4.4.6', 'Array.prototype.pop')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-array.prototype.pop', 'Array.prototype.pop')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-array.prototype.pop', 'Array.prototype.pop')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - -<div> - - -<p>{{Compat("javascript.builtins.Array.pop")}}</p> -</div> - -<h2 id="Ver_também">Ver também </h2> - -<ul> - <li>{{jsxref("Array.prototype.push()")}}</li> - <li>{{jsxref("Array.prototype.shift()")}}</li> - <li>{{jsxref("Array.prototype.unshift()")}}</li> - <li>{{jsxref("Array.prototype.concat()")}}</li> - <li>{{jsxref("Array.prototype.splice()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/array/reverse/index.html b/files/pt-pt/web/javascript/reference/global_objects/array/reverse/index.html deleted file mode 100644 index a442018c61..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/array/reverse/index.html +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: Array.prototype.reverse() -slug: Web/JavaScript/Reference/Global_Objects/Array/reverse -translation_of: Web/JavaScript/Reference/Global_Objects/Array/reverse ---- -<div>{{JSRef}}</div> - -<p>O método <code><strong>reverse()</strong></code> inverte um vector (<code>Array</code>). O primeiro elemento torna-se o último, e o último elemento torna-se o primeiro.</p> - -<pre class="brush: js">var a = ['um', 'dois', 'três']; -a.reverse(); - -console.log(a); // ['três', 'dois', 'um'] -</pre> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><var>a</var>.reverse()</pre> - -<h3 id="Valor_devolvido">Valor devolvido</h3> - -<p>O vector (<code>Array</code>) invertido.</p> - -<h2 id="Descrição">Descrição</h2> - -<p>O método <code>reverse</code> transpõe os elementos do vector que o chamou, mudando o vector, e devolvendo uma referência para o vector.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Invertendo_os_elementos_num_vector">Invertendo os elementos num vector</h3> - -<p>O exemplo que se segue cria um vector <code>a</code>, que contém três elementos, e depois o inverte. A chamada a <code>reverse()</code> devolve uma referência para o vector invertido <code>a</code>.</p> - -<pre class="brush: js">var a = ['um', 'dois', 'três']; -var invertido = a.reverse(); - -console.log(a); // ['três', 'dois', 'um'] -console.log(invertido); // ['três', 'dois', 'um'] -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition. Implemented in JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.4.4.8', 'Array.prototype.reverse')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-array.prototype.reverse', 'Array.prototype.reverse')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-array.prototype.reverse', 'Array.prototype.reverse')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Edge</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatChrome("1.0")}}</td> - <td>{{CompatGeckoDesktop("1.7")}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatIE("5.5")}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("Array.prototype.join()")}}</li> - <li>{{jsxref("Array.prototype.sort()")}}</li> - <li>{{jsxref("TypedArray.prototype.reverse()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/array/slice/index.html b/files/pt-pt/web/javascript/reference/global_objects/array/slice/index.html deleted file mode 100644 index 48820a1ff7..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/array/slice/index.html +++ /dev/null @@ -1,154 +0,0 @@ ---- -title: Array.prototype.slice() -slug: Web/JavaScript/Reference/Global_Objects/Array/slice -tags: - - Array - - JavaScript - - Prototipo - - Referencia - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Array/slice ---- -<div>{{JSRef}}</div> - -<p>O método <code><strong>slice()</strong></code> devolve uma cópia rasa (é feita uma cópia dos <em>pointers</em> se for um objeto) de uma parte de uma matriz num novo objeto de <code>array</code> selecionado do <code>start</code> (início incluído) ao <code>end</code> (fim excluído) onde o <code>start</code> e o <code>end</code> representam o índice de itens dessa matriz. A matriz original não é modificada.</p> - -<div>{{EmbedInteractiveExample("pages/js/array-slice.html")}}</div> - -<p class="hidden">The source for this interactive demo is stored in a GitHub repository. If you'd like to contribute to the interactive demo project, please clone <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> and send us a pull request.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox notranslate"><var>arr</var>.slice([<var>start</var>[, <var>end</var>]]) -</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code><var>start</var></code> {{optional_inline}}</dt> - <dd>Indice de base zero, onde coméça a cópia.</dd> - <dd>Um índice negativo pode ser utilizado, indicando um intervalo a partir do fim da sequência. <code>slice(-2)</code> extrai os dois últimos elementos da sequência.</dd> - <dd>Se <code><var>start</var></code> é undefined, <code>slice</code> coméça a partir do indice <code>0</code>.</dd> - <dd>Se <code><var>start</var></code> é maior que o último índice da sequência, uma matriz vazia é devolvida.</dd> - <dt><code><var>end</var></code> {{optional_inline}}</dt> - <dd>Índice antes do qual se deve terminar a extração. <code>slice</code> extrai até o valor de indice <code>end</code>, mas sem incluir <code>end</code>. Por exemplo, <code>slice(1,4)</code> extrai do segundo até ao quarto elemento (elementos indexados 1, 2, e 3).</dd> - <dd>Pode ser utilizado um índice negativo, indicando o último índice a partir do fim da sequência. <code>slice(2,-1)</code> extrai do terceiro até ao penúltimo elemento na sequência.</dd> - <dd>Se <code>end</code> é omisso, <code>slice</code> extrai todos os elementos até ao fim da sequência (<code>arr.length</code>).</dd> - <dd>Se <code>end</code> é maior que o comprimento da sequência, <code>slice</code> extrai todos os elementos até ao fim da sequência (<code>arr.length</code>).</dd> -</dl> - -<h3 id="Resultado">Resultado</h3> - -<p>Uma matriz nova contendo os elementos extraídos.</p> - -<h2 id="Descrição">Descrição</h2> - -<p><code>slice</code> não altera a matriz original. Devolve uma cópia rasa dos elementos da matriz original. Os elementos da matriz original são copiados para a matriz devolvida como se segue:</p> - -<ul> - <li>Para referências de objectos (e não o objecto real), <code>slice</code> copia as referências de objectos para a nova matriz. Tanto o original como a nova matriz referem-se ao mesmo objecto. Se um objecto referenciado mudar, as mudanças são visíveis tanto para a nova matriz como para a original.</li> - <li>Para strings, números e booleanos (não {{jsxref("String")}}, {{jsxref("Number")}} e {{jsxref("Booleano")}} objetos), <code>slice</code> copia os valores para a nova matriz. Alterações à string, número, ou booleano numa matriz não afetam a outra matriz.</li> -</ul> - -<p>Se um novo elemento é adicionado a qualquer das matrizes, a outra matriz não é afetada.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Devolver_uma_porção_duma_matriz">Devolver uma porção duma matriz</h3> - -<pre class="brush: js notranslate">let fruits = ['Banana', 'Orange', 'Lemon', 'Apple', 'Mango'] -let citrus = fruits.slice(1, 3) - -// fruits contêm ['Banana', 'Orange', 'Lemon', 'Apple', 'Mango'] -// citrus contêm ['Orange','Lemon'] -</pre> - -<h3 id="Usar_slice">Usar <code>slice</code></h3> - -<p>No seguinte exemplo, <code>slice</code> cria uma <em>array</em> (matriz), <code>newCar</code>, a partir de <code>myCar</code>. Ambos incluem uma referência ao objeto <code>myHonda</code>. Quando a propriedade <em>color</em> (cor) de <code>myHonda</code> é mudada para <em>purple</em> (roxo), ambas matrizes refletem a alteração.</p> - -<pre class="brush: js notranslate">// Usando slice, cria newCar a partir de myCar. -let myHonda = { color: 'red', wheels: 4, engine: { cylinders: 4, size: 2.2 } } -let myCar = [myHonda, 2, 'cherry condition', 'purchased 1997'] -let newCar = myCar.slice(0, 2) - -// Imprime os valors de myCar, newCar, a propriadade -// color de myHonda em ambas arrays. -console.log('myCar = ' + JSON.stringify(myCar)) -console.log('newCar = ' + JSON.stringify(newCar)) -console.log('myCar[0].color = ' + myCar[0].color) -console.log('newCar[0].color = ' + newCar[0].color) - -// Mude a propriadade color de myHonda. -myHonda.color = 'purple' -console.log('A nova cor de my Honda é ' + myHonda.color) - -// Imprime a propriadade color de myHonda em ambas arrays. -console.log('myCar[0].color = ' + myCar[0].color) -console.log('newCar[0].color = ' + newCar[0].color) -</pre> - -<p>Este <em>script</em> imprime:</p> - -<pre class="notranslate">myCar = [{color: 'red', wheels: 4, engine: {cylinders: 4, size: 2.2}}, 2, - 'cherry condition', 'purchased 1997'] -newCar = [{color: 'red', wheels: 4, engine: {cylinders: 4, size: 2.2}}, 2] -myCar[0].color = red -newCar[0].color = red -A nova cor de my Honda é purple -myCar[0].color = purple -newCar[0].color = purple -</pre> - -<h3 id="Objetos_parecidos_com_Array">Objetos parecidos com Array</h3> - -<p>O método <code>slice</code> tembém pode ser chamado para converter objetos / coleções do estilo matriz para um objeto <code>Array</code>. É só preciso {{jsxref("Function.prototype.bind", "<em>bind</em>")}} o método ao objeto. Os {{jsxref("Functions/arguments", "argumentos")}} dentro da função são um exemplo de um "objeto de estilo matriz".</p> - -<pre class="brush: js notranslate">function list() { - return Array.prototype.slice.call(arguments) -} - -let list1 = list(1, 2, 3) // [1, 2, 3] -</pre> - -<p><em>Binding</em> pode ser feito com o método {{jsxref("Function.prototype.call", "call()")}} de {{jsxref("Function.prototype")}} e também pode ser simplificado a usar <code>[].slice.call(arguments)</code> invés de <code>Array.prototype.slice.call</code>.</p> - -<p>Pode ser simplificado a usar {{jsxref("Function.prototype.bind", "bind")}}.</p> - -<pre class="brush: js notranslate">let unboundSlice = Array.prototype.slice -let slice = Function.prototype.call.bind(unboundSlice) - -function list() { - return slice(arguments) -} - -let list1 = list(1, 2, 3) // [1, 2, 3]</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-array.prototype.slice', 'Array.prototype.slice')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - - - -<p>{{Compat("javascript.builtins.Array.slice")}}</p> - -<h2 id="Veja_também">Veja também</h2> - -<ul> - <li>{{jsxref("Array.prototype.splice()")}}</li> - <li>{{jsxref("Function.prototype.call()")}}</li> - <li>{{jsxref("Function.prototype.bind()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/arraybuffer/index.html b/files/pt-pt/web/javascript/reference/global_objects/arraybuffer/index.html deleted file mode 100644 index c612f44b26..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/arraybuffer/index.html +++ /dev/null @@ -1,219 +0,0 @@ ---- -title: ArrayBuffer -slug: Web/JavaScript/Reference/Global_Objects/ArrayBuffer -translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer ---- -<div>{{JSRef}}</div> - -<div><strong><code>ArrayBuffer </code></strong>é um objeto utilizado para representar um buffer de dados em binário de tamanho pré-definido. Não é possivel manipular o conteudo do buffer diretamente; em vez disso, tem de se criar um dos <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray">typed array objects</a> ou um objeto {{jsxref("DataView")}} que representa um buffer num formato especifico, e usa-o para ler e escrever o conteudo do buffer. </div> - -<div> </div> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox">new ArrayBuffer(length) -</pre> - -<h3 id="Parametros">Parametros</h3> - -<dl> - <dt><code>length</code></dt> - <dd>O tamanho, em bytes, do array buffer que se pretende criar.</dd> -</dl> - -<h3 id="Retorno">Retorno</h3> - -<p> Um novo objecto do tipo <code>ArrayBuffer</code> do tamanho especificado. O respetivo conteudo é inicializado a 0.</p> - -<h3 id="Excepções">Excepções</h3> - -<p>A {{jsxref("RangeError")}} é lançada caso o tamanho (<code>length) </code>é maior do que<code> </code>{{jsxref("Number.MAX_SAFE_INTEGER")}} (>= 2 ** 53) ou caso seja negativo.</p> - -<h2 id="Descrição">Descrição</h2> - -<p>O construtor de <code>ArrayBuffer</code> cria um novo objeto do tipo <code>ArrayBuffer</code> com o tamanho especificado em bytes.</p> - -<h3 id="Obter_um_array_buffer_a_partir_de_dados_existentes">Obter um array buffer a partir de dados existentes</h3> - -<ul> - <li><a href="/en-US/docs/Web/API/WindowBase64/Base64_encoding_and_decoding#Appendix.3A_Decode_a_Base64_string_to_Uint8Array_or_ArrayBuffer">From a Base64 string</a></li> - <li><a href="/en-US/docs/Web/API/FileReader#readAsArrayBuffer()">From a local file</a></li> -</ul> - -<h2 id="Propriedades">Propriedades</h2> - -<dl> - <dt><code>ArrayBuffer.length</code></dt> - <dd>Propriedade length do construtor de <code>ArrayBuffer </code>cujo valor é 1.</dd> - <dt>{{jsxref("ArrayBuffer.@@species", "get ArrayBuffer[@@species]")}}</dt> - <dd>A função do contrutor que é usado para criar objetos derivados.</dd> - <dt>{{jsxref("ArrayBuffer.prototype")}}</dt> - <dd>Permite adicionar novas propriedades a todos os objetos do tipo <code>ArrayBuffer.</code></dd> -</dl> - -<h2 id="Métodos">Métodos</h2> - -<dl> - <dt>{{jsxref("ArrayBuffer.isView", "ArrayBuffer.isView(arg)")}}</dt> - <dd>Devolve <code>true </code>caso <code>arg </code>é um tipo de representação do ArrayBuffer, como <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray">typed array objects</a> ou {{jsxref("DataView")}}. Devolve <code>false </code>caso contrário</dd> - <dt>{{jsxref("ArrayBuffer.transfer", "ArrayBuffer.transfer(oldBuffer [, newByteLength])")}} {{experimental_inline}}</dt> - <dd>Devolve um novo objeto <code>ArrayBuffer </code>cujo conteúdo é obtido do <code>oldBuffer </code>e ou é truncado ou preenchido a zeros pelo <code> newByteLength.</code></dd> -</dl> - -<h2 id="Instâncias_ArrayBuffer">Instâncias ArrayBuffer</h2> - -<p>Todas as instâncias de <code>ArrayBuffer</code> herdam de {{jsxref("ArrayBuffer.prototype")}}.</p> - -<h3 id="Propriedades_2">Propriedades</h3> - -<p>{{page('en-US/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/prototype','Properties')}}</p> - -<h3 id="Métodos_2">Métodos</h3> - -<p>{{page('en-US/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/prototype','Methods')}}</p> - -<dl> - <dt>{{jsxref("ArrayBuffer.slice()")}} {{non-standard_inline}}</dt> - <dd>Tem a mesma funcionalidade que {{jsxref("ArrayBuffer.prototype.slice()")}}.</dd> -</dl> - -<h2 id="Exemplo">Exemplo</h2> - -<p>Neste exemplo, criamos um buffer de 8 bytes com representação {{jsxref("Global_Objects/Int32Array", "Int32Array")}} a referênciar o buffer:</p> - -<pre class="brush: js">var buffer = new ArrayBuffer(8); -var view = new Int32Array(buffer);</pre> - -<h2 id="Especificação">Especificação</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Status</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('Typed Array')}}</td> - <td>{{Spec2('Typed Array')}}</td> - <td>Substituido por ECMAScript 6.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-arraybuffer-constructor', 'ArrayBuffer')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> - <p>Definição inicial no stardard da ECMA. Especificar que <code>new </code>era necessário.</p> - </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-arraybuffer-constructor', 'ArrayBuffer')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_nos_navegadores">Compatibilidade nos navegadores</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>7.0</td> - <td>{{CompatGeckoDesktop("2")}}</td> - <td>10</td> - <td>11.6</td> - <td>5.1</td> - </tr> - <tr> - <td><code>ArrayBuffer()</code> without <code>new</code> throws</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoDesktop("44")}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td><code>ArrayBuffer.slice()</code> {{non-standard_inline}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatVersionUnknown}}<br> - {{CompatNo}} {{CompatGeckoDesktop("53")}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>4.0</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatGeckoMobile("2")}}</td> - <td>10</td> - <td>11.6</td> - <td>4.2</td> - </tr> - <tr> - <td><code>ArrayBuffer()</code> without <code>new</code> throws</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile("44")}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td><code>ArrayBuffer.slice()</code> {{non-standard_inline}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatVersionUnknown}}<br> - {{CompatNo}} {{CompatGeckoMobile("53")}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Notas_de_compatibilidade">Notas de compatibilidade</h2> - -<p>Com ECMAScript 2015, construtores de <code>ArrayBuffer </code>são obrigados a usar o operador<code> </code>{{jsxref("Operators/new", "new")}}. Daqui adiante ao invocar <code>ArrayBuffer </code>como uma função sem<code> new </code>irá lançar uma exceção {{jsxref("TypeError")}}.</p> - -<pre class="brush: js example-bad">var dv = ArrayBuffer(10); -// TypeError: calling a builtin ArrayBuffer constructor -// without new is forbidden</pre> - -<pre class="brush: js example-good">var dv = new ArrayBuffer(10);</pre> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Typed_arrays">JavaScript typed arrays</a></li> - <li>{{jsxref("SharedArrayBuffer")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/asyncfunction/index.html b/files/pt-pt/web/javascript/reference/global_objects/asyncfunction/index.html deleted file mode 100644 index 4e454bacd9..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/asyncfunction/index.html +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: AsyncFunction -slug: Web/JavaScript/Reference/Global_Objects/AsyncFunction -translation_of: Web/JavaScript/Reference/Global_Objects/AsyncFunction ---- -<div>{{JSRef}}</div> - -<div>O constructor da função <strong>Async</strong> cria um novo objecto {{jsxref("Statements/async_function", "async function")}}. Em Javascript todas as funções asíncronas são na verdade objectos <code>AsyncFunction.</code></div> - -<p> </p> - -<p>Note-se que <code>AsyncFunction</code> não é um objecto global. Pode ser obtido da seguinte forma.</p> - -<pre class="brush: js">Object.getPrototypeOf(async function(){}).constructor -</pre> - -<h2 id="Síntaxe">Síntaxe</h2> - -<pre class="syntaxbox">new AsyncFunction([<var>arg1</var>[, <var>arg2</var>[, ...<var>argN</var>]],] <var>functionBody</var>)</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>arg1, arg2, ... arg<em>N</em></code></dt> - <dd>Nomes usados pela função como nomes formais de argumentos . Cada um dos argumentos tem que ser uma <em>string</em> que corresponde a um identificador válido JavaScript ou uma lista separada por vírgulas; por exemplo "<code>x</code>", "<code>theValue</code>", ou "<code>a,b</code>".</dd> - <dt><code>functionBody</code></dt> - <dd>Uma <em>string</em> com os termos JavaScript que fazem parte da definição da função.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>Os objectos {{jsxref("Statements/async_function", "async function")}} criados com o <em>constructor</em> <code>AsyncFunction</code> passam por um <em>parsing</em> quando as funções são criadas. Isto é menos eficiente que declarar uma função asíncrona com {{jsxref("Statements/async_function", "async function expression")}} e chamá-la no código porque dessa forma a função passa pelo <em>parsing</em> ao mesmo tempo que o resto do código.</p> - -<p>Todos os argumentos passados à função são tratados como os nomes dos identificadores dos parâmetros na função a ser criada, na ordem que são declarados.</p> - -<div class="note"> -<p><strong>Nota:</strong> {{jsxref("Statements/async_function", "async functions")}} criado com o <em>constructor</em> <code>AsyncFunction</code> não estão encapsulados ao contexto da sua criação, são sempre criados no âmbito global.</p> - -<p>Ao correr, podem aceder às suas prórpias variáveis e às variáveis globais, no entanto não conseguem aceder às que estão no contexto donde o constructor <code>AsyncFunction</code> foi chamado. Isto é diferente de chamar {{jsxref("Global_Objects/eval", "eval")}} com código para uma função asíncrona.</p> -</div> - -<p>A invocação do constructor <code>AsyncFunction</code> como uma função, i.e. sem usar o operador <code>new</code> tem o mesmo efeito que invocá-lo como <em>constructor</em>.</p> - -<p>Invoking the <code>AsyncFunction</code> constructor as a function (without using the <code>new</code> operator) has the same effect as invoking it as a constructor.</p> - -<h2 id="Propriedades">Propriedades</h2> - -<dl> - <dt><code><strong>AsyncFunction.length</strong></code></dt> - <dd>A propriedade comprimento do <em>constructor</em> do <code>AsyncFunction</code>, cujo valor é 1.</dd> - <dt>{{jsxref("AsyncFunction.prototype")}}</dt> - <dd>Permite adicionar propriedades a todos os objectos que são funções asíncronas.</dd> -</dl> - -<h2 id="AsyncFunction_prototype_object"><code>AsyncFunction</code> prototype object</h2> - -<h3 id="Propriedades_2">Propriedades</h3> - -<div>{{page('/pt-PT/docs/Web/JavaScript/Reference/Global_Objects/AsyncFunction/prototype', 'Properties')}}</div> - -<h2 id="Instâncias_de_AsyncFunction">Instâncias de <code>AsyncFunction</code></h2> - -<p>As instâncias de <code>AsyncFunction</code> herdam métodos e propriedades do {{jsxref("AsyncFunction.prototype")}}. Tal como com qualquer <em>constructor</em> pode-se mudar o <em>prototype object</em> para aplicar mudanças a todos as instâncias de <code>AsyncFunction</code>.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Exemplo_de_criação_de_uma_função_async_a_partir_de_um_constructor_AsyncFunction">Exemplo de criação de uma função <em>async</em> a partir de um <em>constructor</em> <code>AsyncFunction</code></h3> - -<pre class="brush: js">function resolveAfter2Seconds(x) { - return new Promise(resolve => { - setTimeout(() => { - resolve(x); - }, 2000); - }); -} - -var AsyncFunction = Object.getPrototypeOf(async function(){}).constructor - -var a = new AsyncFunction('a', - 'b', - 'return await resolveAfter2Seconds(a) + await resolveAfter2Seconds(b);'); - -a(10, 20).then(v => { - console.log(v); // prints 30 after 4 seconds -}); -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('ESDraft', '#sec-async-function-objects', 'AsyncFunction object')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Definição inicial em ES2017.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegadores">Compatibilidade de navegadores</h2> - -<div> - - -<p>{{Compat("javascript.builtins.AsyncFunction")}}</p> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("Statements/async_function", "async function function")}}</li> - <li>{{jsxref("Operators/async_function", "async function expression")}}</li> - <li>{{jsxref("Global_Objects/Function", "Function")}}</li> - <li>{{jsxref("Statements/function", "function statement")}}</li> - <li>{{jsxref("Operators/function", "function expression")}}</li> - <li>{{jsxref("Functions_and_function_scope", "Functions and function scope", "", 1)}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/boolean/index.html b/files/pt-pt/web/javascript/reference/global_objects/boolean/index.html deleted file mode 100644 index e8482a2c0e..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/boolean/index.html +++ /dev/null @@ -1,156 +0,0 @@ ---- -title: Booliano -slug: Web/JavaScript/Reference/Global_Objects/Boolean -tags: - - Boolean - - Booliano - - Constructor - - JavaScript -translation_of: Web/JavaScript/Reference/Global_Objects/Boolean ---- -<div>{{JSRef}}</div> - -<p>O objeto <strong><code>Boolean</code></strong> é um <em>wrapper</em> objeto para um valor booliano.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox">new Boolean([<var>value</var>])</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><em><code>value</code></em></dt> - <dd>Opcional. O valor incial do objeto <em><code>Boolean</code></em>.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>The value passed as the first parameter is converted to a boolean value, if necessary. If the value is omitted or is <code>0</code>, <code>-0</code>, {{jsxref("null")}}, <code>false</code>, {{jsxref("NaN")}}, {{jsxref("undefined")}}, or the empty string (<code>""</code>), the object has an initial value of <code>false</code>. If the DOM object {{domxref("document.all")}} is passed as a parameter, the new boolean object also has an initial value of <code>false</code>. All other values, including any object or the string <code>"false"</code>, create an object with an initial value of <code>true</code>.</p> - -<p>Do not confuse the primitive <code>Boolean</code> values <code>true</code> and <code>false</code> with the <code>true</code> and <code>false</code> values of the <code>Boolean</code> object.</p> - -<p>Any object of which the value is not {{jsxref("undefined")}} or {{jsxref("null")}}, including a <code>Boolean</code> object whose value is <code>false</code>, evaluates to <code>true</code> when passed to a conditional statement. For example, the condition in the following {{jsxref("Statements/if...else", "if")}} statement evaluates to <code>true</code>:</p> - -<pre class="brush: js">var x = new Boolean(false); -if (x) { - // this code is executed -} -</pre> - -<p>This behavior does not apply to <code>Boolean</code> primitives. For example, the condition in the following {{jsxref("Statements/if...else", "if")}} statement evaluates to <code>false</code>:</p> - -<pre class="brush: js">var x = false; -if (x) { - // this code is not executed -} -</pre> - -<p>Do not use a <code>Boolean</code> object to convert a non-boolean value to a boolean value. Instead, use <code>Boolean</code> as a function to perform this task:</p> - -<pre class="brush: js">var x = Boolean(expression); // preferred -var x = new Boolean(expression); // don't use -</pre> - -<p>If you specify any object, including a <code>Boolean</code> object whose value is <code>false</code>, as the initial value of a <code>Boolean</code> object, the new <code>Boolean</code> object has a value of <code>true</code>.</p> - -<pre class="brush: js">var myFalse = Boolean(false); // initial value of false -var g = Boolean(myFalse); // initial value of true -var myString = new String('Hello'); // string object -var s = Boolean(myString); // initial value of true -</pre> - -<p>Do not use a <code>Boolean</code> object in place of a <code>Boolean</code> primitive.</p> - -<h2 id="Propriedades">Propriedades</h2> - -<dl> - <dt><code>Boolean.length</code></dt> - <dd>Length property whose value is 1.</dd> - <dt>{{jsxref("Boolean.prototype")}}</dt> - <dd>Represents the prototype for the <code>Boolean</code> constructor.</dd> -</dl> - -<h2 id="Métodos">Métodos</h2> - -<p>While the global <code>Boolean</code> object contains no methods of its own, it does inherit some methods through the prototype chain:</p> - -<h2 id="Instâncias_Boolean">Instâncias <em><code>Boolean</code></em></h2> - -<p>All <code>Boolean</code> instances inherit from {{jsxref("Boolean.prototype")}}. As with all constructors, the prototype object dictates instances' inherited properties and methods.</p> - -<h3 id="Propridades">Propridades</h3> - -<div>{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean/prototype', 'Properties')}}</div> - -<h3 id="Métodos_2">Métodos</h3> - -<div>{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean/prototype', 'Methods')}}</div> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Criar_objetos_Boolean_com_um_valor_inicial_de_false">Criar objetos <em><code>Boolean</code> </em>com um valor inicial de <em><code>false</code></em></h3> - -<pre class="brush: js">var bNoParam = Boolean(); -var bZero = Boolean(0); -var bNull = Boolean(null); -var bEmptyString = Boolean(''); -var bfalse = Boolean(false); -</pre> - -<h3 id="Criar_objetos_Boolean_com_um_valor_inicial_de_verdadeiro">Criar objetos <em><code>Boolean</code> </em>com um valor inicial de <em><code>verdadeiro</code></em></h3> - -<pre class="brush: js">var btrue = Boolean(true); -var btrueString = Boolean('true'); -var bfalseString = Boolean('false'); -var bSuLin = Boolean('Su Lin'); -var bArrayProto = Boolean([]); -var bObjProto = Boolean({}); -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition. Implemented in JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.6', 'Boolean')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-boolean-objects', 'Boolean')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-boolean-objects', 'Boolean')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - -<div> - - -<p>{{Compat("javascript.builtins.Boolean")}}</p> -</div> - -<h2 id="Consulte_também">Consulte também</h2> - -<ul> - <li>{{jsxref("Boolean.prototype")}}</li> - <li>{{Glossary("Booliano")}}</li> - <li><a href="https://pt.wikipedia.org/wiki/Booleano">Tipo de dados Booliano (Wikipedia)</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/encodeuri/index.html b/files/pt-pt/web/javascript/reference/global_objects/encodeuri/index.html deleted file mode 100644 index 5f8c84ca8e..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/encodeuri/index.html +++ /dev/null @@ -1,152 +0,0 @@ ---- -title: encodeURI() -slug: Web/JavaScript/Reference/Global_Objects/encodeURI -translation_of: Web/JavaScript/Reference/Global_Objects/encodeURI ---- -<div>{{jsSidebar("Objects")}}</div> - -<p>O método <code><strong>encodeURI()</strong></code> codifica um Uniform Resource Identifier (URI) substituindo cada instancia de determinados caracteres por um, dois, três, ou quatro sequências de escape que representem a codificação UTF-8 do caracter (apenas serão quatro sequências de caracteres de escape para caracteres compostos por dois caracteres de "substituição").</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><code>encodeURI(<em>URI</em>)</code></pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>URI</code></dt> - <dd>Um Uniform Resource Identifier completo.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>Assumindo que o URI é um URI completo, não serão codificados caracteres reservados que tenham significado especial no URI.</p> - -<p><code>encodeURI</code> substitui todos os caracteres <strong>excepto</strong> as seguintes sequências de escape UTF-8:</p> - -<table class="standard-table"> - <tbody> - <tr> - <td class="header">Tipo</td> - <td class="header">Incluído</td> - </tr> - <tr> - <td>Caracteres reservados</td> - <td><code>;</code> <code>,</code> <code>/</code> <code>?</code> <code>:</code> <code>@</code> <code>&</code> <code>=</code> <code>+</code> <code>$</code></td> - </tr> - <tr> - <td>Caracteres excluídos</td> - <td>alfabéticos, dígitos decimais , <code>-</code> <code>_</code> <code>.</code> <code>!</code> <code>~</code> <code>*</code> <code>'</code> <code>(</code> <code>)</code></td> - </tr> - <tr> - <td>Ponto</td> - <td><code>#</code></td> - </tr> - </tbody> -</table> - -<p>Note-se que o método <code>encodeURI</code> <em>não consegue</em> criar correctamente os pedidos HTTP GET e POST, o mesmo aplica-se para XMLHTTPRequests, porque os caracteres "&", "+", e "=" não são codificados, por se tratarem de caracteres especiais nos pedidos GET e POST. {{jsxref("encodeURIComponent")}}, no entanto, codifica estes caracteres.</p> - -<p>Note-se que será lançado um {{jsxref("URIError")}} caso se tente codificar um substituto que não faça parte de um par superior-inferior, p.ex.,</p> - -<pre class="brush: js">// par superior-inferior ok -console.log(encodeURI('\uD800\uDFFF')); - -// substituição única de par superior lança "URIError: malformed URI sequence" -console.log(encodeURI('\uD800')); - -// substituição única de par inferior lança "URIError: malformed URI sequence" -console.log(encodeURI('\uDFFF')); </pre> - -<p>Note-se também que caso se pretenda seguir a mais recente norma para URLs <a href="http://tools.ietf.org/html/rfc3986">RFC3986</a>, que torna os parênteses rectos reservados (para IPv6) e, por consequência, não será codificado quando fizer parte de um URL (como um host), o seguinte exemplo de código pode ajudar:</p> - -<pre class="brush: js">function fixedEncodeURI (str) { - return encodeURI(str).replace(/%5B/g, '[').replace(/%5D/g, ']'); -}</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.1.3.3', 'encodeURI')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-encodeuri-uri', 'encodeURI')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_com_navegador">Compatibilidade com navegador</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Veja_também">Veja também</h2> - -<ul> - <li>{{jsxref("decodeURI")}}</li> - <li>{{jsxref("encodeURIComponent")}}</li> - <li>{{jsxref("decodeURIComponent")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/function/arguments/index.html b/files/pt-pt/web/javascript/reference/global_objects/function/arguments/index.html deleted file mode 100644 index 4c9bf9e96e..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/function/arguments/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: Function.arguments -slug: Web/JavaScript/Reference/Global_Objects/Function/arguments -translation_of: Web/JavaScript/Reference/Global_Objects/Function/arguments ---- -<div>{{JSRef}} {{deprecated_header}}</div> - -<div>A propriedade <strong><code><em>function.arguments</em></code></strong> refere-se a um objecto com aspecto de <em>array</em> que corresponde aos argumentos da função. Ao invés disso, use a variável {{jsxref("Functions/arguments", "arguments")}}. Esta propriedade é proibida no modo <em>strict</em> devido ao <em><a href="http://www.ecma-international.org/ecma-262/6.0/#sec-addrestrictedfunctionproperties">tail call optimization</a></em>.</div> - -<h2 id="Descrição">Descrição</h2> - -<p>A síntaxe <code>function.arguments</code> está obsoleta. A forma recomendade de aceder ao objecto {{jsxref("Functions/arguments", "arguments")}} disponível nas função é usar simplesment a variável {{jsxref("Functions/arguments", "arguments")}}.</p> - -<p>No caso de recursão isto é, se uma funão <code>f</code> aparece várias vezes na <em>stack, </em>o valor de <code>f.arguments</code> representa os argumentos correspondentes à mais recente chamada da função.</p> - -<p>O valor da propriedade <code>arguments</code> é tipicamente <em>null</em> se não há nenuma invocação da função a acontecer, ou seja, a função foi chamada mas ainda não retornou.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<pre class="brush: js">function f(n) { g(n - 1); } - -function g(n) { - console.log('antes: ' + g.arguments[0]); - if (n > 0) { f(n); } - console.log('depois: ' + g.arguments[0]); -} - -f(2); - -console.log('retornado: ' + g.arguments); - -// Output - -// antes: 1 -// antes: 0 -// depois: 0 -// depois: 1 -// retornado: null -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td> - <p>Definição inicial. Implementado em JavaScript 1.0. Tornado obsoleto a favor de {{jsxref("Functions/arguments", "arguments")}} em ES3.</p> - </td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-10.6', 'arguments object')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Objecto {{jsxref("Functions/arguments", "arguments")}}</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-arguments-object', 'arguments object')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Objecto {{jsxref("Functions/arguments", "arguments")}}</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-arguments-object', 'arguments object')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Objecto {{jsxref("Functions/arguments", "arguments")}}</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_navegadores">Compatibilidade navegadores</h2> - -<div> - - -<p>{{Compat("javascript.builtins.Function.arguments")}}</p> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>Objecto {{jsxref("Functions/arguments", "arguments")}}</li> - <li>{{jsxref("Functions", "Functions and function scope", "", 1)}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/function/call/index.html b/files/pt-pt/web/javascript/reference/global_objects/function/call/index.html deleted file mode 100644 index fa3faee130..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/function/call/index.html +++ /dev/null @@ -1,164 +0,0 @@ ---- -title: Function.prototype.call() -slug: Web/JavaScript/Reference/Global_Objects/Function/call -tags: - - Function - - JavaScript - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Function/call ---- -<div>{{JSRef}}</div> - -<p>O método <code><strong>call()</strong></code> realiza a chamada de uma função com o parâmetros <code>this</code> além de outros parâmetros fornecidos individualmente.</p> - -<div>{{EmbedInteractiveExample("pages/js/function-call.html")}}</div> - - - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox notranslate"><var>func</var>.call([<var>thisArg</var>[, <var>arg1</var>, <var>arg2</var>, ...<var>argN</var>]])</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><em><code>thisArg</code></em> {{optional_inline}}</dt> - <dd>O valor de <code>this</code> fornecido ao chamar <code><em>func</em></code>.</dd> -</dl> - -<div class="blockIndicator note"> -<p>Aviso: Em certos casos, <em><code>thisArg</code></em> pode não ser o valor que o método vê.</p> - -<p>Se o método for uma função em {{jsxref("Strict_mode", "non-strict mode", "", 1)}}, {{jsxref("Global_Objects/null", "null")}} e {{jsxref("Global_Objects/undefined", "undefined")}} são substituídos pelo objeto global, e valores primitivos são convertidos em objetos.</p> -</div> - -<dl> - <dt><em><code>arg1, arg2, ...argN</code></em> {{optional_inline}}</dt> - <dd>Parâmetros para a função.</dd> -</dl> - -<h3 id="Resultado">Resultado</h3> - -<p>O resultado ao chamar a função em questão com os parâmetros <code>this</code> e os outros argumentos especificados.</p> - -<h2 id="Descrição">Descrição</h2> - -<p><code>call()</code> permite uma função / método pertencendo a um objeto, ser atribuída a outro objeto e ser chamada desse mesmo.</p> - -<p><code>call()</code> fornece um novo valor para <code>this</code> à função / método. Com <code>call()</code>, pode escrever um método uma vez, e depois herdar o método noutro objeto, sem ter de rescrever a função para o novo objeto.</p> - -<div class="blockIndicator note"> -<p>Nota: Apesar de a sintaxe da função ser quase idêntica à da {{jsxref("Function.prototype.apply", "apply()")}}, a principal diferença é que <code>call()</code> aceita uma <strong>lista de argumentos</strong> (<code>arg1, arg2, ...argN</code>), enquanto <code>apply()</code> aceita <strong>uma matriz de argumentos</strong> (<code>[arg1, arg2, ...argN]</code>).</p> -</div> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Usar_call_para_encadear_construtores_dum_objeto">Usar <code>call</code> para encadear construtores dum objeto</h3> - -<p>É possível utilizar <code>call</code> para encadear construtores para um objeto (como em Java).</p> - -<p>No exemplo abaixo, o construtor para o objeto <code>Product</code> é definido com dois parâmetros: <code>name</code> e <code>price</code>.</p> - -<p>Duas outras funções, <code>Food</code> e <code>Toy</code>, invocam <code>Product</code> passando os parâmetros <code>this</code><font face="Open Sans, arial, sans-serif">, </font><code>name</code> e <code>price</code>. As funções <code>Food</code> e <code>Toy</code> também definem a propriadade <code>category</code>.</p> - -<pre class="brush: js notranslate">function Product(name, price) { - this.name = name; - this.price = price; -} - -function Food(name, price) { - Product.call(this, name, price); - this.category = 'food'; -} - -function Toy(name, price) { - Product.call(this, name, price); - this.category = 'toy'; -} - -const cheese = new Food('feta', 5); -const fun = new Toy('robot', 40);</pre> - -<h3 id="Usar_call_para_invocar_uma_função_anónima">Usar <code>call</code> para invocar uma função anónima</h3> - -<p>Neste exemplo, criamos uma função anónima e utilizamos <code>call</code> para invocá-la em cada objeto na matriz.</p> - -<p>O principal objetivo da função anónima é inserir a função <code>print</code> em cada objeto. A função <code>print</code> imprimir o índice do objeto na matriz em que se encontra.</p> - -<div class="blockIndicator note"> -<p>Passar o objeto desta forma (como <code>this</code>) não é necessário, mas foi feito de forma a exemplificar a função.</p> -</div> - -<pre class="brush: js notranslate">var animals = [ - { species: 'Lion', name: 'King' }, - { species: 'Whale', name: 'Fail' } -]; - -for (var i = 0; i < animals.length; i++) { - (function(i) { - this.print = function() { - console.log('#' + i + ' ' + this.species - + ': ' + this.name); - } - this.print(); - }).call(animals[i], i); -} -</pre> - -<h3 id="Usar_call_para_invocar_a_função_sem_especificar_o_primeiro_argumento">Usar <code>call</code> para invocar a função sem especificar o primeiro argumento</h3> - -<p>No exemplo abaixo, quando chamamos a função <code>display</code> sem passar o primeiro argumento. Se o primeiro argumento não é especificado, o objeto global é atribuído a <code>this</code>.<br> - </p> - -<pre class="brush: js notranslate">var sData = 'Wisen'; - -function display() { - console.log('sData value is %s ', this.sData); -} - -display.call(); // sData value is Wisen</pre> - -<div class="note"> -<p><strong>Aviso:</strong> Em "strict mode", o valor de <code>this</code> é <code>undefined</code>, exemplificado em baixo.</p> -</div> - -<pre class="brush: js notranslate">'use strict'; - -var sData = 'Wisen'; - -function display() { - console.log('sData value is %s ', this.sData); -} - -display.call(); // Cannot read the property of 'sData' of undefined</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-function.prototype.call', 'Function.prototype.call')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - - - -<p>{{Compat("javascript.builtins.Function.call")}}</p> - -<h2 id="Veja_também">Veja também</h2> - -<ul> - <li>{{jsxref("Function.prototype.bind()")}}</li> - <li>{{jsxref("Function.prototype.apply()")}}</li> - <li> - <p><a href="/en-US/docs/Web/JavaScript/Introduction_to_Object-Oriented_JavaScript">Introduction to Object-Oriented JavaScript</a></p> - </li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/function/index.html b/files/pt-pt/web/javascript/reference/global_objects/function/index.html deleted file mode 100644 index 6ebfd66c44..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/function/index.html +++ /dev/null @@ -1,192 +0,0 @@ ---- -title: Function -slug: Web/JavaScript/Reference/Global_Objects/Function -tags: - - Constructor - - Function - - JavaScript - - NeedsTranslation - - TopicStub -translation_of: Web/JavaScript/Reference/Global_Objects/Function ---- -<div>{{JSRef}}</div> - -<p>The <strong><code>Function</code> constructor</strong> creates a new <code>Function</code> object. In JavaScript every function is actually a <code>Function</code> object.</p> - -<h2 id="Syntax">Syntax</h2> - -<pre class="syntaxbox"><code>new Function ([<var>arg1</var>[, <var>arg2</var>[, ...<var>argN</var>]],] <var>functionBody</var>)</code></pre> - -<h3 id="Parameters">Parameters</h3> - -<dl> - <dt><code>arg1, arg2, ... arg<em>N</em></code></dt> - <dd>Names to be used by the function as formal argument names. Each must be a string that corresponds to a valid JavaScript identifier or a list of such strings separated with a comma; for example "<code>x</code>", "<code>theValue</code>", or "<code>a,b</code>".</dd> - <dt><code>functionBody</code></dt> - <dd>A string containing the JavaScript statements comprising the function definition.</dd> -</dl> - -<h2 id="Description">Description</h2> - -<p><code>Function</code> objects created with the <code>Function</code> constructor are parsed when the function is created. This is less efficient than declaring a function with a <a href="/en-US/docs/Web/JavaScript/Reference/Operators/function">function expression</a> or <a href="/en-US/docs/Web/JavaScript/Reference/Statements/function">function statement</a> and calling it within your code, because such functions are parsed with the rest of the code.</p> - -<p>All arguments passed to the function are treated as the names of the identifiers of the parameters in the function to be created, in the order in which they are passed.</p> - -<p>Invoking the <code>Function</code> constructor as a function (without using the <code>new</code> operator) has the same effect as invoking it as a constructor.</p> - -<h2 id="Properties_and_Methods_of_Function">Properties and Methods of <code>Function</code></h2> - -<p>The global <code>Function</code> object has no methods or properties of its own, however, since it is a function itself it does inherit some methods and properties through the prototype chain from {{jsxref("Function.prototype")}}.</p> - -<h2 id="Function_prototype_object"><code>Function</code> prototype object</h2> - -<h3 id="Properties">Properties</h3> - -<div>{{page('/en-US/docs/JavaScript/Reference/Global_Objects/Function/prototype', 'Properties')}}</div> - -<h3 id="Methods">Methods</h3> - -<div>{{page('/en-US/docs/JavaScript/Reference/Global_Objects/Function/prototype', 'Methods')}}</div> - -<h2 id="Function_instances"><code>Function</code> instances</h2> - -<p><code>Function</code> instances inherit methods and properties from {{jsxref("Function.prototype")}}. As with all constructors, you can change the constructor's prototype object to make changes to all <code>Function</code> instances.</p> - -<h2 id="Examples">Examples</h2> - -<h3 id="Specifying_arguments_with_the_Function_constructor">Specifying arguments with the <code>Function</code> constructor</h3> - -<p>The following code creates a <code>Function</code> object that takes two arguments.</p> - -<pre class="brush: js">// Example can be run directly in your JavaScript console - -// Create a function that takes two arguments and returns the sum of those arguments -var adder = new Function('a', 'b', 'return a + b'); - -// Call the function -adder(2, 6); -// > 8 -</pre> - -<p>The arguments "<code>a</code>" and "<code>b</code>" are formal argument names that are used in the function body, "<code>return a + b</code>".</p> - -<h3 id="Difference_between_Function_constructor_and_function_declaration">Difference between Function constructor and function declaration</h3> - -<p>Functions created with the <code>Function</code> constructor do not create closures to their creation contexts; they always are created in the global scope. When running them, they will only be able to access their own local variables and global ones, not the ones from the scope in which the <code>Function</code> constructor was called. This is different from using {{jsxref("eval")}} with code for a function expression.</p> - -<pre class="brush: js">var x = 10; - -function createFunction1() { - var x = 20; - return new Function('return x;'); // this |x| refers global |x| -} - -function createFunction2() { - var x = 20; - function f() { - return x; // this |x| refers local |x| above - } - return f; -} - -var f1 = createFunction1(); -console.log(f1()); // 10 -var f2 = createFunction2(); -console.log(f2()); // 20 -</pre> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition. Implemented in JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.3', 'Function')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-function-objects', 'Function')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-function-objects', 'Function')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("Functions", "Functions and function scope")}}</li> - <li>{{jsxref("Function")}}</li> - <li>{{jsxref("Statements/function", "function statement")}}</li> - <li>{{jsxref("Operators/function", "function expression")}}</li> - <li>{{jsxref("Statements/function*", "function* statement")}}</li> - <li>{{jsxref("Operators/function*", "function* expression")}}</li> - <li>{{jsxref("GeneratorFunction")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/index.html b/files/pt-pt/web/javascript/reference/global_objects/index.html deleted file mode 100644 index f3850bdfd2..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/index.html +++ /dev/null @@ -1,173 +0,0 @@ ---- -title: Objetos integrados padrão -slug: Web/JavaScript/Reference/Global_Objects -tags: - - Built-in - - JavaScript - - Objects - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects ---- -<div>{{jsSidebar("Objects")}}</div> - -<h2 id="Summary" name="Summary">Resumo</h2> - -<p>Este capítulo documenta todos os objectos built-in do JavaScript standard, juntamente com os seus métodos e propriedades.</p> - -<div class="onlyinclude"> -<p>O termo "objectos globais" (ou objectos built-in standard) não é para ser confundido com <em>objecto global</em>. Aqui, os objectos globais referem-se a objectos no scope global (mas apenas se o modo strict do ECMAScript 5 não estiver a ser usado! Senão retorna <code>undefined</code>). O próprio <em>global object</em> pode ser acedido através do operador {{jsxref("Operators/this", "this")}} no scope global. Na verdade, o scope global consiste nas propriedades do objecto global (incluíndo propriedades herdadas, se alguma).</p> - -<p>Outros objectos no scope global são <a href="/en-US/docs/Web/JavaScript/Guide/Working_with_Objects#Creating_new_objects">criados através do script do utilizador</a> or fornecidos pela aplicação host. Os objectos do host disponíveis no contexto browser são documentados na <a href="/en-US/docs/Web/API/Reference">referência da API</a>. Para mais informações sobre a distinção entre <a href="/en-US/docs/DOM/DOM_Reference">DOM</a> e o núcleo do <a href="/en-US/docs/Web/JavaScript">JavaScript</a>, ver <a href="/en-US/docs/Web/JavaScript/JavaScript_technologies_overview">exposição das tecnologias do JavaScript</a>.</p> - -<h2 id="Objetos_padrão_(por_categoria)">Objetos padrão (por categoria)</h2> - -<h3 id="Propriedades_do_valor">Propriedades do valor</h3> - -<p>Estas propriedades globais devolvem um valor simples; estas não têm propriedades ou métodos.</p> - -<ul> - <li>{{jsxref("Infinity")}}</li> - <li>{{jsxref("NaN")}}</li> - <li>{{jsxref("undefined")}}</li> - <li>{{jsxref("null")}} literal</li> -</ul> - -<h3 id="Propriedades_da_função">Propriedades da função</h3> - -<p>Estas funções globais - funções que são chamadas no mundo ao invés de um objeto - devolvem diretamente os seus resultados para o chamador.</p> - -<ul> - <li>{{jsxref("Global_Objects/eval", "eval()")}}</li> - <li>{{jsxref("Global_Objects/uneval", "uneval()")}} {{non-standard_inline()}}</li> - <li>{{jsxref("Global_Objects/isFinite", "isFinite()")}}</li> - <li>{{jsxref("Global_Objects/isNaN", "isNaN()")}}</li> - <li>{{jsxref("Global_Objects/parseFloat", "parseFloat()")}}</li> - <li>{{jsxref("Global_Objects/parseInt", "parseInt()")}}</li> - <li>{{jsxref("Global_Objects/decodeURI", "decodeURI()")}}</li> - <li>{{jsxref("Global_Objects/decodeURIComponent", "decodeURIComponent()")}}</li> - <li>{{jsxref("Global_Objects/encodeURI", "encodeURI()")}}</li> - <li>{{jsxref("Global_Objects/encodeURIComponent", "encodeURIComponent()")}}</li> - <li>{{jsxref("Global_Objects/escape", "escape()")}} {{deprecated_inline()}}</li> - <li>{{jsxref("Global_Objects/unescape", "unescape()")}} {{deprecated_inline()}}</li> -</ul> - -<h3 id="Objetos_fundamentais">Objetos fundamentais</h3> - -<p>Estes são os objetos básicos, fundamentais, em que todos os outros objetos são baseados. Isto inclui objetos que representam objetos gerais, funções, e erros.</p> - -<ul> - <li>{{jsxref("Object")}}</li> - <li>{{jsxref("Function")}}</li> - <li>{{jsxref("Boolean")}}</li> - <li>{{jsxref("Symbol")}} {{experimental_inline()}}</li> - <li>{{jsxref("Error")}}</li> - <li>{{jsxref("EvalError")}}</li> - <li>{{jsxref("InternalError")}}</li> - <li>{{jsxref("RangeError")}}</li> - <li>{{jsxref("ReferenceError")}}</li> - <li>{{jsxref("StopIteration")}}</li> - <li>{{jsxref("SyntaxError")}}</li> - <li>{{jsxref("TypeError")}}</li> - <li>{{jsxref("URIError")}}</li> -</ul> - -<h3 id="Números_e_datas">Números e datas</h3> - -<p>Objectos que lidam com números, datas e cálculos matemáticos.</p> - -<ul> - <li>{{jsxref("Number")}}</li> - <li>{{jsxref("Math")}}</li> - <li>{{jsxref("Date")}}</li> -</ul> - -<h3 id="Processamento_de_texto">Processamento de texto</h3> - -<p>Objectos para manipular texto.</p> - -<ul> - <li>{{jsxref("String")}}</li> - <li>{{jsxref("RegExp")}}</li> -</ul> - -<h3 id="Coleções_indexadas">Coleções indexadas</h3> - -<p>Coleções ordenadas por um indíce. Objectos do tipo array.</p> - -<ul> - <li>{{jsxref("Array")}}</li> - <li>{{jsxref("Int8Array")}}</li> - <li>{{jsxref("Uint8Array")}}</li> - <li>{{jsxref("Uint8ClampedArray")}}</li> - <li>{{jsxref("Int16Array")}}</li> - <li>{{jsxref("Uint16Array")}}</li> - <li>{{jsxref("Int32Array")}}</li> - <li>{{jsxref("Uint32Array")}}</li> - <li>{{jsxref("Float32Array")}}</li> - <li>{{jsxref("Float64Array")}}</li> - <li>{{jsxref("ParallelArray")}} {{non-standard_inline()}}</li> -</ul> - -<h3 id="Coleções_por_chave">Coleções por chave</h3> - -<p>Coleções de objectos como chaves. Elementos iteráveis por ordem de inserção.</p> - -<ul> - <li>{{jsxref("Map")}} {{experimental_inline()}}</li> - <li>{{jsxref("Set")}} {{experimental_inline()}}</li> - <li>{{jsxref("WeakMap")}} {{experimental_inline()}}</li> - <li>{{jsxref("WeakSet")}} {{experimental_inline()}}</li> -</ul> - -<h3 id="Dados_estruturados">Dados estruturados</h3> - -<p>Buffers de dados e <strong>J</strong>ava<strong>S</strong>cript <strong>O</strong>bject <strong>N</strong>otation (JSON).</p> - -<ul> - <li>{{jsxref("ArrayBuffer")}}</li> - <li>{{jsxref("DataView")}}</li> - <li>{{jsxref("JSON")}}</li> -</ul> - -<h3 id="Objectos_de_abstração_de_controlo">Objectos de abstração de controlo</h3> - -<ul> - <li>{{jsxref("Iterator")}} {{non-standard_inline()}}</li> - <li>{{jsxref("Generator")}} {{experimental_inline()}}</li> - <li>{{jsxref("Promise")}} {{experimental_inline()}}</li> -</ul> - -<h3 id="Reflexão">Reflexão</h3> - -<ul> - <li>{{jsxref("Reflect")}} {{experimental_inline()}}</li> - <li>{{jsxref("Proxy")}} {{experimental_inline()}}</li> -</ul> - -<h3 id="Internacionalização">Internacionalização</h3> - -<p>Adições ao núcleo do ECMAScript para funcionalidades de linguagens sensíveis.</p> - -<ul> - <li>{{jsxref("Intl")}}</li> - <li>{{jsxref("Global_Objects/Collator", "Intl.Collator")}}</li> - <li>{{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}</li> - <li>{{jsxref("Global_Objects/NumberFormat", "Intl.NumberFormat")}}</li> -</ul> - -<h3 id="Objetos_não_padrão">Objetos não padrão</h3> - -<ul> - <li>{{jsxref("Iterator")}} {{non-standard_inline}}</li> - <li>{{jsxref("ParallelArray")}} {{non-standard_inline}}</li> - <li>{{jsxref("StopIteration")}} {{non-standard_inline}}</li> -</ul> - -<h3 id="Outros">Outros</h3> - -<ul> - <li><code><a href="/en-US/docs/Web/JavaScript/Reference/Functions/arguments">Argumentos</a></code></li> -</ul> -</div> - -<p> </p> diff --git a/files/pt-pt/web/javascript/reference/global_objects/infinity/index.html b/files/pt-pt/web/javascript/reference/global_objects/infinity/index.html deleted file mode 100644 index 818471e60e..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/infinity/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Infinity -slug: Web/JavaScript/Reference/Global_Objects/Infinity -tags: - - JavaScript - - Propriedade - - Referencia -translation_of: Web/JavaScript/Reference/Global_Objects/Infinity ---- -<div>{{jsSidebar("Objects")}}</div> - -<p>A propriedade global <code><strong>Infinity</strong></code> é um valor numérico que representa o infinito.</p> - -<p>{{js_property_attributes(0,0,0)}}</p> - -<div>{{EmbedInteractiveExample("pages/js/globalprops-infinity.html")}}</div> - -<div class="hidden">The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> and send us a pull request.</div> - -<h2 id="Descrição">Descrição</h2> - -<p><code>Infinity</code> é uma propriedade do objeto <code>global</code>. Isto é para dizer que é um variável com um escopo global.</p> - -<p>O valor inicial do <code>Infinity</code> é {{jsxref("Number.POSITIVE_INFINITY")}}. O valor <code>Infinity</code> (infinito positivo) é maior que qualquer outro número.</p> - -<p>Este valor age de form diferente do infinito matematico; veja {{jsxref("Number.POSITIVE_INFINITY")}} para mais detalhes.</p> - -<p>Como definido na especificação ECMAScript 5, <code>Infinity</code> é <em>read-only</em> (implementado em JavaScript 1.8.5 / Firefox 4).</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Usar_Infinity">Usar Infinity</h3> - -<pre class="brush: js notranslate">console.log(Infinity ); /* Infinity */ -console.log(Infinity + 1 ); /* Infinity */ -console.log(Math.pow(10, 1000)); /* Infinity */ -console.log(Math.log(0) ); /* -Infinity */ -console.log(1 / Infinity ); /* 0 */ -console.log(1 / 0 ); /* Infinity */ -</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-value-properties-of-the-global-object-infinity', 'Infinity')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - - - -<p>{{Compat("javascript.builtins.Infinity")}}</p> - -<h2 id="Veja_também">Veja também</h2> - -<ul> - <li>{{jsxref("Number.NEGATIVE_INFINITY")}}</li> - <li>{{jsxref("Number.POSITIVE_INFINITY")}}</li> - <li>{{jsxref("Number.isFinite")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/math/ceil/index.html b/files/pt-pt/web/javascript/reference/global_objects/math/ceil/index.html deleted file mode 100644 index c89b15567a..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/math/ceil/index.html +++ /dev/null @@ -1,161 +0,0 @@ ---- -title: Math.ceil() -slug: Web/JavaScript/Reference/Global_Objects/Math/ceil -translation_of: Web/JavaScript/Reference/Global_Objects/Math/ceil ---- -<div>{{JSRef}}</div> - -<p>A função <strong><code>Math.ceil()</code></strong> retorna um inteiro smallest (sem casas decimais) maior ou igual ao n.º passado como parâmetro. Por exemplo ao fazer Math.ceil(3.01) o valor retornado é 4, ao fazer Math.ceil(-5.01) o retorno é -5, ao fazer Math.ceil(7) o valor devolvido é 7. </p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><code>Math.ceil(<var>x</var>)</code></pre> - -<h3 id="Parametros">Parametros</h3> - -<dl> - <dt><code>x</code></dt> - <dd>Um número.</dd> -</dl> - -<h3 id="Valor_de_retorno">Valor de retorno</h3> - -<p>Um inteiro smallest maior ou igual ao n.º passado como parâmetro.</p> - -<h2 id="Descrição">Descrição</h2> - -<p>Como <code>ceil()</code> é um método estático de <code>Math</code>, pode sempre ser usado como <code>Math.ceil()</code>, o objeto <code>Math</code> não é um construtor. </p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Utilizando_Math.ceil">Utilizando <code>Math.ceil()</code></h3> - -<p>Seguem exemplos da utilização de <code>Math.ceil()</code>.</p> - -<pre class="brush: js">Math.ceil(.95); // 1 -Math.ceil(4); // 4 -Math.ceil(7.004); // 8 -Math.ceil(-0.95); // -0 -Math.ceil(-4); // -4 -Math.ceil(-7.004); // -7 -</pre> - -<h3 id="Ajustamento_decimal">Ajustamento decimal </h3> - -<pre class="brush: js">// Closure -(function() { - /** - * Decimal adjustment of a number. - * - * @param {String} type The type of adjustment. - * @param {Number} value The number. - * @param {Integer} exp The exponent (the 10 logarithm of the adjustment base). - * @returns {Number} The adjusted value. - */ - function decimalAdjust(type, value, exp) { - // If the exp is undefined or zero... - if (typeof exp === 'undefined' || +exp === 0) { - return Math[type](value); - } - value = +value; - exp = +exp; - // If the value is not a number or the exp is not an integer... - if (isNaN(value) || !(typeof exp === 'number' && exp % 1 === 0)) { - return NaN; - } - // Shift - value = value.toString().split('e'); - value = Math[type](+(value[0] + 'e' + (value[1] ? (+value[1] - exp) : -exp))); - // Shift back - value = value.toString().split('e'); - return +(value[0] + 'e' + (value[1] ? (+value[1] + exp) : exp)); - } - - // Decimal round - if (!Math.round10) { - Math.round10 = function(value, exp) { - return decimalAdjust('round', value, exp); - }; - } - // Decimal floor - if (!Math.floor10) { - Math.floor10 = function(value, exp) { - return decimalAdjust('floor', value, exp); - }; - } - // Decimal ceil - if (!Math.ceil10) { - Math.ceil10 = function(value, exp) { - return decimalAdjust('ceil', value, exp); - }; - } -})(); - -// Round -Math.round10(55.55, -1); // 55.6 -Math.round10(55.549, -1); // 55.5 -Math.round10(55, 1); // 60 -Math.round10(54.9, 1); // 50 -Math.round10(-55.55, -1); // -55.5 -Math.round10(-55.551, -1); // -55.6 -Math.round10(-55, 1); // -50 -Math.round10(-55.1, 1); // -60 -// Floor -Math.floor10(55.59, -1); // 55.5 -Math.floor10(59, 1); // 50 -Math.floor10(-55.51, -1); // -55.6 -Math.floor10(-51, 1); // -60 -// Ceil -Math.ceil10(55.51, -1); // 55.6 -Math.ceil10(51, 1); // 60 -Math.ceil10(-55.59, -1); // -55.5 -Math.ceil10(-59, 1); // -50 -</pre> - -<h2 id="Especificações">Especificações </h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Definição inicial JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.8.2.6', 'Math.ceil')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-math.ceil', 'Math.ceil')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-math.ceil', 'Math.ceil')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> - -<p>{{Compat("javascript.builtins.Math.ceil")}}</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("Math.abs()")}}</li> - <li>{{jsxref("Math.floor()")}}</li> - <li>{{jsxref("Math.round()")}}</li> - <li>{{jsxref("Math.sign()")}}</li> - <li>{{jsxref("Math.trunc()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/math/index.html b/files/pt-pt/web/javascript/reference/global_objects/math/index.html deleted file mode 100644 index 867c783782..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/math/index.html +++ /dev/null @@ -1,214 +0,0 @@ ---- -title: Math -slug: Web/JavaScript/Reference/Global_Objects/Math -translation_of: Web/JavaScript/Reference/Global_Objects/Math ---- -<div>{{JSRef}}</div> - -<p><strong><code>Math</code></strong> é um objecto integrado que tem propriedades e métodos correspondentes a constantes e funções matemáticas. Não é um objecto função.</p> - -<h2 id="Descrição">Descrição</h2> - -<p>Contrariamente aos outros objectos globais, <code>Math</code> não é um construtor. Todas as propriedades e métodos de <code>Math</code> são estáticas. Refere-se a constante pi com <code>Math.PI</code> e chama-se a função de seno com <code>Math.sin(x)</code>, em que x é o argumento do método. As constantes estão definidas com a precisão completa dos números reais do JavaScript.</p> - -<p>Para extender o objecto <code>Math</code>, não se usa o protótipo. Em vez disso extende-se directamente o objecto <code>Math</code>:</p> - -<p>Math.nomeProp=valorProp;</p> - -<p>Math.nomeMetodo=refMetodo;</p> - -<h2 id="Propriedades">Propriedades</h2> - -<dl> - <dt>{{jsxref("Math.E")}}</dt> - <dd>Euler's constant and the base of natural logarithms, approximately 2.718.</dd> - <dt>{{jsxref("Math.LN2")}}</dt> - <dd>Natural logarithm of 2, approximately 0.693.</dd> - <dt>{{jsxref("Math.LN10")}}</dt> - <dd>Natural logarithm of 10, approximately 2.303.</dd> - <dt>{{jsxref("Math.LOG2E")}}</dt> - <dd>Base 2 logarithm of E, approximately 1.443.</dd> - <dt>{{jsxref("Math.LOG10E")}}</dt> - <dd>Base 10 logarithm of E, approximately 0.434.</dd> - <dt>{{jsxref("Math.PI")}}</dt> - <dd>Ratio of the circumference of a circle to its diameter, approximately 3.14159.</dd> - <dt>{{jsxref("Math.SQRT1_2")}}</dt> - <dd>Square root of 1/2; equivalently, 1 over the square root of 2, approximately 0.707.</dd> - <dt>{{jsxref("Math.SQRT2")}}</dt> - <dd>Square root of 2, approximately 1.414.</dd> -</dl> - -<h2 id="Métodos">Métodos</h2> - -<div class="note"> -<p>Note that the trigonometric functions (<code>sin()</code>, <code>cos()</code>, <code>tan()</code>, <code>asin()</code>, <code>acos()</code>, <code>atan()</code>, <code>atan2()</code>) expect or return angles in radians. To convert radians to degrees, divide by <code>(Math.PI / 180)</code>, and multiply by this to convert the other way.</p> -</div> - -<div class="note"> -<p>Note that many math functions have a precision that's implementation-dependent. This means that different browsers can give a different result, and even the same JS engine on a different OS or architecture can give different results.</p> -</div> - -<dl> - <dt>{{jsxref("Global_Objects/Math/abs", "Math.abs(x)")}}</dt> - <dd>Returns the absolute value of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/acos", "Math.acos(x)")}}</dt> - <dd>Returns the arccosine of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/acosh", "Math.acosh(x)")}}</dt> - <dd>Returns the hyperbolic arccosine of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/asin", "Math.asin(x)")}}</dt> - <dd>Returns the arcsine of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/asinh", "Math.asinh(x)")}}</dt> - <dd>Returns the hyperbolic arcsine of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/atan", "Math.atan(x)")}}</dt> - <dd>Returns the arctangent of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/atanh", "Math.atanh(x)")}}</dt> - <dd>Returns the hyperbolic arctangent of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/atan2", "Math.atan2(y, x)")}}</dt> - <dd>Returns the arctangent of the quotient of its arguments.</dd> - <dt>{{jsxref("Global_Objects/Math/cbrt", "Math.cbrt(x)")}}</dt> - <dd>Returns the cube root of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/ceil", "Math.ceil(x)")}}</dt> - <dd>Returns the smallest integer greater than or equal to a number.</dd> - <dt>{{jsxref("Global_Objects/Math/clz32", "Math.clz32(x)")}}</dt> - <dd>Returns the number of leading zeroes of a 32-bit integer.</dd> - <dt>{{jsxref("Global_Objects/Math/cos", "Math.cos(x)")}}</dt> - <dd>Returns the cosine of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/cosh", "Math.cosh(x)")}}</dt> - <dd>Returns the hyperbolic cosine of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/exp", "Math.exp(x)")}}</dt> - <dd>Returns E<sup>x</sup>, where <var>x</var> is the argument, and E is Euler's constant (2.718…), the base of the natural logarithm.</dd> - <dt>{{jsxref("Global_Objects/Math/expm1", "Math.expm1(x)")}}</dt> - <dd>Returns subtracting 1 from <code>exp(x)</code>.</dd> - <dt>{{jsxref("Global_Objects/Math/floor", "Math.floor(x)")}}</dt> - <dd>Returns the largest integer less than or equal to a number.</dd> - <dt>{{jsxref("Global_Objects/Math/fround", "Math.fround(x)")}}</dt> - <dd>Returns the nearest <a href="http://en.wikipedia.org/wiki/Single-precision_floating-point_format" title="link to the wikipedia page on single precision">single precision</a> float representation of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/hypot", "Math.hypot([x[, y[, …]]])")}}</dt> - <dd>Returns the square root of the sum of squares of its arguments.</dd> - <dt>{{jsxref("Global_Objects/Math/imul", "Math.imul(x, y)")}}</dt> - <dd>Returns the result of a 32-bit integer multiplication.</dd> - <dt>{{jsxref("Global_Objects/Math/log", "Math.log(x)")}}</dt> - <dd>Returns the natural logarithm (log<sub>e</sub>, also ln) of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/log1p", "Math.log1p(x)")}}</dt> - <dd>Returns the natural logarithm (log<sub>e</sub>, also ln) of <code>1 + x</code> for a number x.</dd> - <dt>{{jsxref("Global_Objects/Math/log10", "Math.log10(x)")}}</dt> - <dd>Returns the base 10 logarithm of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/log2", "Math.log2(x)")}}</dt> - <dd>Returns the base 2 logarithm of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/max", "Math.max([x[, y[, …]]])")}}</dt> - <dd>Returns the largest of zero or more numbers.</dd> - <dt>{{jsxref("Global_Objects/Math/min", "Math.min([x[, y[, …]]])")}}</dt> - <dd>Returns the smallest of zero or more numbers.</dd> - <dt>{{jsxref("Global_Objects/Math/pow", "Math.pow(x, y)")}}</dt> - <dd>Returns base to the exponent power, that is, <code>base<sup>exponent</sup></code>.</dd> - <dt>{{jsxref("Global_Objects/Math/random", "Math.random()")}}</dt> - <dd>Returns a pseudo-random number between 0 and 1.</dd> - <dt>{{jsxref("Global_Objects/Math/round", "Math.round(x)")}}</dt> - <dd>Returns the value of a number rounded to the nearest integer.</dd> - <dt>{{jsxref("Global_Objects/Math/sign", "Math.sign(x)")}}</dt> - <dd>Returns the sign of the x, indicating whether x is positive, negative or zero.</dd> - <dt>{{jsxref("Global_Objects/Math/sin", "Math.sin(x)")}}</dt> - <dd>Returns the sine of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/sinh", "Math.sinh(x)")}}</dt> - <dd>Returns the hyperbolic sine of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/sqrt", "Math.sqrt(x)")}}</dt> - <dd>Returns the positive square root of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/tan", "Math.tan(x)")}}</dt> - <dd>Returns the tangent of a number.</dd> - <dt>{{jsxref("Global_Objects/Math/tanh", "Math.tanh(x)")}}</dt> - <dd>Returns the hyperbolic tangent of a number.</dd> - <dt><code>Math.toSource()</code> {{non-standard_inline}}</dt> - <dd>Returns the string <code>"Math"</code>.</dd> - <dt>{{jsxref("Global_Objects/Math/trunc", "Math.trunc(x)")}}</dt> - <dd>Returns the integral part of the number x, removing any fractional digits.</dd> -</dl> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition. Implemented in JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.8', 'Math')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-math-object', 'Math')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>New methods {{jsxref("Math.log10()", "log10()")}}, {{jsxref("Math.log2()", "log2()")}}, {{jsxref("Math.log1p()", "log1p()")}}, {{jsxref("Math.expm1()", "expm1()")}}, {{jsxref("Math.cosh()", "cosh()")}}, {{jsxref("Math.sinh()", "sinh()")}}, {{jsxref("Math.tanh()", "tanh()")}}, {{jsxref("Math.acosh()", "acosh()")}}, {{jsxref("Math.asinh()", "asinh()")}}, {{jsxref("Math.atanh()", "atanh()")}}, {{jsxref("Math.hypot()", "hypot()")}}, {{jsxref("Math.trunc()", "trunc()")}}, {{jsxref("Math.sign()", "sign()")}}, {{jsxref("Math.imul()", "imul()")}}, {{jsxref("Math.fround()", "fround()")}}, {{jsxref("Math.cbrt()", "cbrt()")}} and {{jsxref("Math.clz32()", "clz32()")}} added.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-math-object', 'Math')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("Number")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/number/index.html b/files/pt-pt/web/javascript/reference/global_objects/number/index.html deleted file mode 100644 index 9ac8497a44..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/number/index.html +++ /dev/null @@ -1,213 +0,0 @@ ---- -title: Number -slug: Web/JavaScript/Reference/Global_Objects/Number -tags: - - JavaScript - - Number - - Reference - - TopicStub -translation_of: Web/JavaScript/Reference/Global_Objects/Number ---- -<div>{{JSRef}}</div> - -<p>O objecto JavaScript <strong><code>Number</code></strong> é um objecto abstraído que te permite trabalhar com valores numéricos. Um objecto <code>Number</code> é criado usando o constructor <code>Number().</code></p> - -<h2 id="Constructor">Constructor</h2> - -<pre class="syntaxbox">new Number(valor);</pre> - -<h3 id="Parâmetro">Parâmetro</h3> - -<dl> - <dt><code>valor</code></dt> - <dd>O valor numérico representado pelo objecto que está a ser criado.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>Os usos mais comuns para o objecto <code>Number</code> são:</p> - -<ul> - <li>Se o argumento não puder ser convertido num número, retorna {{jsxref("NaN")}}.</li> - <li>Num contexto não-constructor (isto é, sem o operador {{jsxref("Operators/new", "new")}}), <code>Number</code> pode ser usado para uma conversão de tipo.</li> -</ul> - -<h2 id="Propriedades">Propriedades</h2> - -<dl> - <dt>{{jsxref("Number.EPSILON")}} {{experimental_inline}}</dt> - <dd>O intervalo mais pequeno entre dois números representáveis.</dd> - <dt>{{jsxref("Number.MAX_SAFE_INTEGER")}} {{experimental_inline}}</dt> - <dd>O maior inteiro bem representado em JavaScript (<code>2<sup>53</sup> - 1</code>).</dd> - <dt>{{jsxref("Number.MAX_VALUE")}}</dt> - <dd>O maior número positivo representável.</dd> - <dt>{{jsxref("Number.MIN_SAFE_INTEGER")}} {{experimental_inline}}</dt> - <dd>O menor inteiro bem representado em JavaScript (<code>-(2<sup>53</sup> - 1)</code>).</dd> - <dt>{{jsxref("Number.MIN_VALUE")}}</dt> - <dd>O menor número positivo representável - ou seja, o número positivo mais próximo de zero (sem ser o zero).</dd> - <dt>{{jsxref("Number.NaN")}}</dt> - <dd>Valor especial para representar um "não número".</dd> - <dt>{{jsxref("Number.NEGATIVE_INFINITY")}}</dt> - <dd>Valor especial para representar o infinito negativo; retornado em caso de overflow.</dd> - <dt>{{jsxref("Number.POSITIVE_INFINITY")}}</dt> - <dd>Valor especial para representar o infinito; retornado em caso de overflow.</dd> - <dt>{{jsxref("Number.prototype")}}</dt> - <dd>Permite adicionar propriedades ao objecto <code>Number</code>.</dd> -</dl> - -<h2 id="Métodos">Métodos</h2> - -<dl> - <dt>{{jsxref("Number.isNaN()")}} {{experimental_inline}}</dt> - <dd>Determina se o valor passado é NaN.</dd> - <dt>{{jsxref("Number.isFinite()")}} {{experimental_inline}}</dt> - <dd>Determina se o valor passado é um número finito.</dd> - <dt>{{jsxref("Number.isInteger()")}} {{experimental_inline}}</dt> - <dd>Determina se o número passado é um inteiro.</dd> - <dt>{{jsxref("Number.isSafeInteger()")}} {{experimental_inline}}</dt> - <dd>Determina se o valor passado é um inteiro bem representado (número entre <code>-(2<sup>53</sup> - 1)</code> e <code>2<sup>53</sup> - 1</code>).</dd> - <dt><s class="obsoleteElement">{{jsxref("Number.toInteger()")}} {{obsolete_inline}}</s></dt> - <dd><s class="obsoleteElement">Usado para avaliar o valor passado e convertê-lo num inteiro (ou {{jsxref("Global_Objects/Infinity", "Infinity")}}), mas foi removido.</s></dd> - <dt>{{jsxref("Number.parseFloat()")}} {{experimental_inline}}</dt> - <dd>O valor é o mesmo que {{jsxref("Global_Objects/parseFloat", "parseFloat()")}} de um objecto global.</dd> - <dt>{{jsxref("Number.parseInt()")}} {{experimental_inline}}</dt> - <dd>O valor é o mesmo que {{jsxref("Global_Objects/parseInt", "parseInt()")}} de um objecto global.</dd> -</dl> - -<h2 id="Instâncias_de_Number"><code>Instâncias de Number</code></h2> - -<p>Todas as instâncias de <code>Number </code>herdam de {{jsxref("Number.prototype")}}. O objecto protótipo (prototype) do constructor de <code>Number</code> pode ser modificado para afectar todas as instâncias de <code>Number</code>.</p> - -<h3 id="Métodos_2">Métodos</h3> - -<div>{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/prototype', 'Methods')}}</div> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Usar_o_objecto_Number_para_atribuír_valores_a_variáveis_numéricas">Usar o objecto <code>Number </code>para atribuír valores a variáveis numéricas</h3> - -<p>O seguinte exemplo usa as propriedades do objecto <code>Number</code> para atribuír valores a várias variáveis numéricas: </p> - -<pre class="brush: js">var biggestNum = Number.MAX_VALUE; -var smallestNum = Number.MIN_VALUE; -var infiniteNum = Number.POSITIVE_INFINITY; -var negInfiniteNum = Number.NEGATIVE_INFINITY; -var notANum = Number.NaN; -</pre> - -<h3 id="Limite_inteiro_para_Number"><code>Limite inteiro para Number</code></h3> - -<p>O seguinte exemplo mostra o mínimo e máximo valores inteiros que podem ser representados como um objecto <code>Number</code> (para mais detalhes, consulta o standard do ECMAScript, capítulo <em>8.5 The Number Type</em>):</p> - -<pre class="brush: js">var biggestInt = 9007199254740992; -var smallestInt = -9007199254740992; -</pre> - -<p>Ao analisar dados que foram serializados para JSON, os valores inteiros fora deste limite são expectáveis de ficar corrompidos quando o analisador de JSON os tentar converter para o tipo <code>Number</code>. Como possível alternativa, usa {{jsxref("String")}}.</p> - -<h3 id="Usar_Number_para_converter_um_objecto_Date">Usar <code>Number </code>para converter um objecto <code>Date</code></h3> - -<p>O seguinte exemplo converte o objecto {{jsxref("Date")}} num valor numérico usando <code>Number</code> como função:</p> - -<pre class="brush: js">var d = new Date('December 17, 1995 03:24:00'); -console.log(Number(d)); -</pre> - -<p>Este código imprime "819199440000".</p> - -<h3 id="Converter_strings_numéricas_para_números">Converter strings numéricas para números</h3> - -<pre class="brush: js">Number("123") // 123 -Number("") // 0 -Number("0x11") // 17 -Number("0b11") // 3 -Number("0o11") // 9 -Number("foo") // NaN -Number("100a") // NaN -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Definição inicial. Implementado em JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.7', 'Number')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-number-objects', 'Number')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Adicionados novas propriedades e métodos: ({{jsxref("Number.EPSILON", "EPSILON")}}, {{jsxref("Number.isFinite", "isFinite")}}, {{jsxref("Number.isInteger", "isInteger")}}, {{jsxref("Number.isNaN", "isNaN")}}, {{jsxref("Number.parseFloat", "parseFloat")}}, {{jsxref("Number.parseInt", "parseInt")}})</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{jsxref("NaN")}}</li> - <li>The {{jsxref("Math")}} global object</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/number/isfinite/index.html b/files/pt-pt/web/javascript/reference/global_objects/number/isfinite/index.html deleted file mode 100644 index 9b70ca6a98..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/number/isfinite/index.html +++ /dev/null @@ -1,126 +0,0 @@ ---- -title: Number.isFinite() -slug: Web/JavaScript/Reference/Global_Objects/Number/isFinite -tags: - - Experimental - - Finite - - JavaScript - - Method - - Método(2) - - Number - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Number/isFinite ---- -<div>{{JSRef}}</div> - -<p>O método <strong><code>Number.isFinite()</code></strong> determina se o valor passado é um número finito.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><code>Number.isFinite(valor)</code></pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>valor</code></dt> - <dd>O valor a ser testado.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>Em comparação com a função global {{jsxref("Global_Objects/isFinite", "isFinite()")}}, <strong><code>Number.isFinite()</code></strong> não converte forçosamente o parâmetro num number. Isto significa que apenas para valores do tipo number, finitos, retorna <code>true</code>.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<pre class="brush: js">Number.isFinite(Infinity); // false -Number.isFinite(NaN); // false -Number.isFinite(-Infinity); // false - -Number.isFinite(0); // true -Number.isFinite(2e64); // true - -Number.isFinite('0'); // false, teria sido true com a função - // global isFinite('0') -</pre> - -<h2 id="Polyfill">Polyfill</h2> - -<pre class="brush: js">Number.isFinite = Number.isFinite || function(value) { - return typeof value === "number" && isFinite(value); -} -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-number.isfinite', 'Number.isInteger')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatChrome("19")}}</td> - <td>{{CompatGeckoDesktop("16")}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatOpera("15")}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile("16")}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>O objecto {{jsxref("Global_Objects/Number", "Number")}} ao qual pertence.</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/number/isinteger/index.html b/files/pt-pt/web/javascript/reference/global_objects/number/isinteger/index.html deleted file mode 100644 index 8c6dc79bb7..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/number/isinteger/index.html +++ /dev/null @@ -1,125 +0,0 @@ ---- -title: Number.isInteger() -slug: Web/JavaScript/Reference/Global_Objects/Number/isInteger -tags: - - Experimental - - JavaScript - - Method - - Método(2) - - Number - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Number/isInteger ---- -<div>{{JSRef}}</div> - -<p>O método <strong><code>Number.isInteger()</code></strong> determina se o valor passado é um inteiro.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><code>Number.isInteger(valor)</code></pre> - -<h3 id="Parâmteros">Parâmteros</h3> - -<dl> - <dt><code>valor</code></dt> - <dd>O valor a ser testado por ser um inteiro.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>Se o valor a ser testado for um inteiro, retorna <code>true</code>, senão retorna <code>false</code>. Se o valor for {{jsxref("Global_Objects/NaN", "NaN")}} ou infinito, retorna <code>false</code>.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<pre class="brush: js">Number.isInteger(0.1); // false -Number.isInteger(1); // true -Number.isInteger(Math.PI); // false -Number.isInteger(-100000); // true -Number.isInteger(NaN); // false -Number.isInteger(0); // true -Number.isInteger("10"); // false -</pre> - -<h2 id="Polyfill">Polyfill</h2> - -<pre class="brush: js">Number.isInteger = Number.isInteger || function(value) { - return typeof value === "number" && - isFinite(value) && - Math.floor(value) === value; -}; -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-number.isinteger', 'Number.isInteger')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Definição inicial.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatGeckoDesktop("16")}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatGeckoMobile("16")}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>O objecto {{jsxref("Global_Objects/Number", "Number")}} ao qual pertence.</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/number/isnan/index.html b/files/pt-pt/web/javascript/reference/global_objects/number/isnan/index.html deleted file mode 100644 index 0b242adbbe..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/number/isnan/index.html +++ /dev/null @@ -1,136 +0,0 @@ ---- -title: Number.isNaN() -slug: Web/JavaScript/Reference/Global_Objects/Number/isNaN -tags: - - ECMAScript6 - - Experimental - - JavaScript - - Method - - Método(2) - - Number -translation_of: Web/JavaScript/Reference/Global_Objects/Number/isNaN ---- -<div>{{JSRef}}</div> - -<p>O método <strong><code>Number.isNaN()</code></strong> determina se o valor passado é {{jsxref("Global_Objects/NaN", "NaN")}}. Esta é uma versão mais robusta que {{jsxref("Global_Objects/isNaN", "isNaN()")}}.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><code>Number.isNaN(valor)</code></pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>valor</code></dt> - <dd>O valor a ser testado se é {{jsxref("Global_Objects/NaN", "NaN")}}.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>Due to both equality operators, {{jsxref("Operators/Comparison_Operators", "==", "#Equality")}} and {{jsxref("Operators/Comparison_Operators", "===", "#Identity")}}, evaluating to <code>false</code> when checking if {{jsxref("Global_Objects/NaN", "NaN")}} <em>is</em> {{jsxref("Global_Objects/NaN", "NaN")}}, the function <code>Number.isNaN()</code> has become necessary. This situation is unlike all other possible value comparisons in JavaScript.</p> - -<p>In comparison to the global {{jsxref("Global_Objects/isNaN", "isNaN()")}} function, <code>Number.isNaN()</code> doesn't suffer the problem of forcefully converting the parameter to a number. This means it is now safe to pass values that would normally convert to {{jsxref("Global_Objects/NaN", "NaN")}}, but aren't actually the same value as {{jsxref("Global_Objects/NaN", "NaN")}}. This also means that only values of the type number, that are also {{jsxref("Global_Objects/NaN", "NaN")}}, return <code>true</code>.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<pre class="brush: js">Number.isNaN(NaN); // true -Number.isNaN(Number.NaN); // true -Number.isNaN(0 / 0) // true - -// e.g. these would have been true with global isNaN() -Number.isNaN("NaN"); // false -Number.isNaN(undefined); // false -Number.isNaN({}); // false -Number.isNaN("blabla"); // false - -// These all return false -Number.isNaN(true); -Number.isNaN(null); -Number.isNaN(37); -Number.isNaN("37"); -Number.isNaN("37.37"); -Number.isNaN(""); -Number.isNaN(" "); -</pre> - -<h2 id="Polyfill">Polyfill</h2> - -<pre class="brush: js">Number.isNaN = Number.isNaN || function(value) { - return typeof value === "number" && isNaN(value); -}</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-number.isnan', 'Number.isnan')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Definição inicial.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatChrome("25")}}</td> - <td>{{CompatGeckoDesktop("15")}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>9</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile("15")}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>iOS 9+</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{jsxref("Global_Objects/Number", "Number")}}</li> - <li>{{jsxref("Global_Objects/isNaN", "isNaN()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/number/max_value/index.html b/files/pt-pt/web/javascript/reference/global_objects/number/max_value/index.html deleted file mode 100644 index cd1666ecbc..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/number/max_value/index.html +++ /dev/null @@ -1,119 +0,0 @@ ---- -title: Number.MAX_VALUE -slug: Web/JavaScript/Reference/Global_Objects/Number/MAX_VALUE -tags: - - JavaScript - - Number - - Property - - Propriedade -translation_of: Web/JavaScript/Reference/Global_Objects/Number/MAX_VALUE ---- -<div>{{JSRef}}</div> - -<p>A propriedade <strong><code>Number.MAX_VALUE </code></strong>representa o máximo valor numérico representável em JavaScript.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Descrição">Descrição</h2> - -<p>A propriedade <code>MAX_VALUE</code> tem um valor aproximado de <code>1.79E+308</code>. Valores maiores do que <code>MAX_VALUE</code> são representados como "<code>Infinity</code>".</p> - -<p>Dado que <code>MAX_VALUE</code> é uma propriedade estática (static) de {{jsxref("Number")}}, tu deves sempre usá-la na forma <code>Number.MAX_VALUE</code>, em vez de na forma de uma propriedade de um objecto {{jsxref("Number")}} que tenhas criado.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Usando_MAX_VALUE">Usando <code>MAX_VALUE</code></h3> - -<p>O seguinte código multiplica dois valores numéricos. Se o resultado for inferior ou igual a <code>MAX_VALUE</code>, a função <code>func1</code> é chamada; senão será chamada a função <code>func2</code>.</p> - -<pre class="brush: js">if (num1 * num2 <= Number.MAX_VALUE) { - func1(); -} else { - func2(); -} -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Definição inicial. Implementado em JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.7.3.2', 'Number.MAX_VALUE')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-number.max_value', 'Number.MAX_VALUE')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{jsxref("Number.MIN_VALUE")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/number/min_value/index.html b/files/pt-pt/web/javascript/reference/global_objects/number/min_value/index.html deleted file mode 100644 index 852b37426b..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/number/min_value/index.html +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: Number.MIN_VALUE -slug: Web/JavaScript/Reference/Global_Objects/Number/MIN_VALUE -tags: - - JavaScript - - Number - - Property - - Propriedade -translation_of: Web/JavaScript/Reference/Global_Objects/Number/MIN_VALUE ---- -<div>{{JSRef}}</div> - -<p>A propriedade <strong><code>Number.MIN_VALUE </code></strong>representa o mínimo valor numérico representável em JavaScript.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Descrição">Descrição</h2> - -<p>A propriedade <code>MIN_VALUE</code> representa o valor mais próximo de 0 (zero), não negativo, que o JavaScript consegue representar.</p> - -<p>A propriedade <code>MIN_VALUE</code> tem um valor aproximado de <code>5e-324</code>. Valores menores do que <code>MIN_VALUE </code>("underflow values") são são convertidos para 0 (zero).</p> - -<p>Dado que <code>MIN_VALUE</code> é uma propriedade estática (static) de {{jsxref("Number")}}, tu deves sempre usá-la na forma <code>Number.MIN_VALUE</code>, em vez de na forma de uma propriedade de um objecto {{jsxref("Number")}} que tenhas criado.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Usando_MIN_VALUE">Usando <code>MIN_VALUE</code></h3> - -<p>O seguinte código divide dois valores numéricos. Se o resultado for superior ou igual a <code>MIN_VALUE</code>, a função <code>func1</code> é chamada; senão será chamada a função <code>func2</code>.</p> - -<pre class="brush: js">if (num1 / num2 >= Number.MIN_VALUE) { - func1(); -} else { - func2(); -} -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition. Implemented in JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.7.3.3', 'Number.MIN_VALUE')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-number.min_value', 'Number.MIN_VALUE')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{jsxref("Number.MAX_VALUE")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/number/nan/index.html b/files/pt-pt/web/javascript/reference/global_objects/number/nan/index.html deleted file mode 100644 index c3213486b7..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/number/nan/index.html +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: Number.NaN -slug: Web/JavaScript/Reference/Global_Objects/Number/NaN -tags: - - JavaScript - - Number - - Property - - Propriedade -translation_of: Web/JavaScript/Reference/Global_Objects/Number/NaN ---- -<div>{{JSRef}}</div> - -<p>A propriedade <strong><code>Number.NaN </code></strong>representa um Não-Número. Equivalente a {{jsxref("NaN")}}.</p> - -<p>Não precisas de criar um objecto {{jsxref("Number")}} para aceder a esta propriedade estática (static) (usa <code>Number.NaN</code>).</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Definição inicial. Implementado no JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.7.3.4', 'Number.NaN')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-number.nan', 'Number.NaN')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>O objecto global {{jsxref("NaN")}}.</li> - <li>O objecto {{jsxref("Number")}} ao qual pertence.</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/number/negative_infinity/index.html b/files/pt-pt/web/javascript/reference/global_objects/number/negative_infinity/index.html deleted file mode 100644 index a2a7d0f962..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/number/negative_infinity/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: Number.NEGATIVE_INFINITY -slug: Web/JavaScript/Reference/Global_Objects/Number/NEGATIVE_INFINITY -tags: - - JavaScript - - Number - - Propriedade - - Referencia -translation_of: Web/JavaScript/Reference/Global_Objects/Number/NEGATIVE_INFINITY ---- -<div>{{JSRef}}</div> - -<p>A propriedade <strong><code>Number.NEGATIVE_INFINITY</code></strong> representa o valor negativo Infinito.</p> - -<p>Não tem de criar um objecto {{jsxref("Number")}} para aceder a esta propriedade estática (usa <code>Number.NEGATIVE_INFINITY</code>).</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Descrição">Descrição</h2> - -<p>O valor de <code>Number.NEGATIVE_INFINITY</code> é o mesmo que o valor negativo da propriedade {{jsxref("Infinity")}} do objeto global.</p> - -<p>Este valor comporta-se de forma ligeiramente diferente do infinito matemático:</p> - -<ul> - <li>Qualquer valor positivo, incluindo {{jsxref("Number.POSITIVE_INFINITY", "POSITIVE_INFINITY")}}, multiplicado por <code>NEGATIVE_INFINITY</code> é igual a <code>NEGATIVE_INFINITY</code>.</li> - <li>Qualquer valor negativo, incluindo,<code>NEGATIVE_INFINITY</code> multiplicado por <code>NEGATIVE_INFINITY</code> é igual a {{jsxref("Number.POSITIVE_INFINITY", "POSITIVE_INFINITY")}}.</li> - <li>O valor 0 (zero) multiplicado por <code>NEGATIVE_INFINITY</code> é igual a {{jsxref("NaN")}}.</li> - <li>{{jsxref("NaN")}} multiplicado por <code>NEGATIVE_INFINITY</code> é igual a {{jsxref("NaN")}}.</li> - <li><code>NEGATIVE_INFINITY</code>, dividido por qualquer valor negativo excepto <code>NEGATIVE_INFINITY</code>, é igual a {{jsxref("Number.POSITIVE_INFINITY", "POSITIVE_INFINITY")}}.</li> - <li><code>NEGATIVE_INFINITY</code>, dividido por qualquer valor positivo exceto {{jsxref("Number.POSITIVE_INFINITY", "POSITIVE_INFINITY")}}, é igual a <code>NEGATIVE_INFINITY</code>.</li> - <li><code>NEGATIVE_INFINITY</code>, dividido por outro <code>NEGATIVE_INFINITY</code> ou {{jsxref("Number.POSITIVE_INFINITY", "POSITIVE_INFINITY")}}, é igual a {{jsxref("NaN")}}.</li> - <li>Qualquer número dividido por <code>NEGATIVE_INFINITY</code> é igual a 0 (zero).</li> -</ul> - -<p>Pode usar a propriedade <code>Number.NEGATIVE_INFINITY</code> para indicar uma condição de erro numa situação em que, no caso de sucesso, é retornado um valor finito.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Usando_NEGATIVE_INFINITY">Usando <code>NEGATIVE_INFINITY</code></h3> - -<p>No seguinte exemplo, é atribuído à variável <code>smallNumber</code> um valor inferior ao valor mínimo. Quando a linha de código {{jsxref("Statements/if...else", "if")}} é executada, a variável <code>smallNumber</code> tem o valor <code>-Infinity</code>, então é atribuída à mesma variável um valor finito antes de continuar.</p> - -<pre class="brush: js notranslate">var smallNumber = (-Number.MAX_VALUE) * 2; - -if (smallNumber == Number.NEGATIVE_INFINITY) { - smallNumber = returnFinite(); -} -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition. Implemented in JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.7.3.5', 'Number.NEGATIVE_INFINITY')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-number.negative_infinity', 'Number.NEGATIVE_INFINITY')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade">Compatibilidade</h2> - -<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> - -<p>{{Compat("javascript.builtins.Number.NEGATIVE_INFINITY")}}</p> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{jsxref("Number.POSITIVE_INFINITY")}}</li> - <li>{{jsxref("Number.isFinite()")}}</li> - <li>{{jsxref("Global_Objects/Infinity", "Infinity")}}</li> - <li>{{jsxref("Global_Objects/isFinite", "isFinite()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/number/tostring/index.html b/files/pt-pt/web/javascript/reference/global_objects/number/tostring/index.html deleted file mode 100644 index 1ff4892314..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/number/tostring/index.html +++ /dev/null @@ -1,146 +0,0 @@ ---- -title: Number.prototype.toString() -slug: Web/JavaScript/Reference/Global_Objects/Number/toString -tags: - - JavaScript - - Number - - Prototype - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Number/toString ---- -<div>{{JSRef}}</div> - -<p>O método <strong><code>toString()</code></strong> retorna uma string com o valor do objecto {{jsxref("Number")}} especificado.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><code><var>numObj</var>.toString([<var>radix</var>])</code></pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>base</code></dt> - <dd>Opcional. Um inteiro entre [2, 36] especificando a base usada para representar o valor númerico.</dd> -</dl> - -<h3 id="Erros_possíveis">Erros possíveis</h3> - -<dl> - <dt>{{jsxref("RangeError")}}</dt> - <dd>Se o valor do parâmetro base não estiver entre [2, 36], o erro {{jsxref("RangeError")}} é lançado.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>O objecto {{jsxref("Number")}} faz override ao método <code>toString()</code> do objecto {{jsxref("Object")}}; não herda de {{jsxref("Object.prototype.toString()")}}. Para os objectos {{jsxref( "Number")}}, o método <code>toString() </code>retorna uma representação em string do ojecto na base especificada.</p> - -<p>O método <code>toString() </code>analisa o seu primeiro argumento e tenta retornar uma representação em string na base especificada. Para bases superiores a 10, as letras do alfabeto representam numerais maiores do que 9 (por ordem alfabética: a, b, c ...). Por exemplo, para números hexadecimais (base 16) são usadasa as letras do alfabeto até <code>f</code>.</p> - -<p>Se a <code>base </code>não for especificada, o seu valor assumido é 10.</p> - -<p>Se o <code><var>numObj </var></code>tem um valor negativo (< 0), o sinal é preservado. O mesmo se aplica se a base tiver o valor 2; a string retornada é a representação positiva do binário de <code><var>numObj </var></code>precedida pelo sinal negativo (-), e não complement para 2 de <code>numObj</code>.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Usando_toString">Usando <code>toString</code></h3> - -<pre class="brush: js">var count = 10; - -console.log(count.toString()); // imprime '10' -console.log((17).toString()); // imprime '17' - -var x = 6; - -console.log(x.toString(2)); // imprime '110' -console.log((254).toString(16)); // imprime 'fe' - -console.log((-10).toString(2)); // imprime '-1010' -console.log((-0xff).toString(2)); // imprime'-11111111' -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Definição inicial. Implementado em JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.7.4.2', 'Number.prototype.tostring')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-number.prototype.tostring', 'Number.prototype.tostring')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>BSuporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{jsxref("Number.prototype.toFixed()")}}</li> - <li>{{jsxref("Number.prototype.toExponential()")}}</li> - <li>{{jsxref("Number.prototype.toPrecision()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/object/hasownproperty/index.html b/files/pt-pt/web/javascript/reference/global_objects/object/hasownproperty/index.html deleted file mode 100644 index 2c91823404..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/object/hasownproperty/index.html +++ /dev/null @@ -1,187 +0,0 @@ ---- -title: Object.prototype.hasOwnProperty() -slug: Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty -tags: - - JavaScript - - Objeto - - Prototipo - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty ---- -<div>{{JSRef}}</div> - -<p>O método <code><strong>hasOwnProperty()</strong></code> retorna um booleano indicando se o objeto tem a propriedade especificada.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><code><var>obj</var>.hasOwnProperty(<var>prop</var>)</code></pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>prop</code></dt> - <dd>O nome da propriedade para testar.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>Cada objecto descendente de {{jsxref("Object")}} herda o método <code>hasOwnProperty</code>. Este método pode ser usado para determinar se um objecto contém a propriedade especificada como uma propriedade direta desse objeto; ao contrário do operador {{jsxref("Operators/in", "in")}}, este método não verifica a cadeia de objetos do protótipo.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Usando_hasOwnProperty_para_testar_a_existência_de_uma_propriedade">Usando <code>hasOwnProperty</code> para testar a existência de uma propriedade</h3> - -<p>O seguinte exemplo determina se o objecto "o" contém a propriedade "<code>prop"</code>:</p> - -<pre class="brush: js">o = new Object(); -o.prop = 'existe'; - -function changeO() { - o.newprop = o.prop; - delete o.prop; -} - -o.hasOwnProperty('prop'); // retorna true -changeO(); -o.hasOwnProperty('prop'); // retorna false -</pre> - -<h3 id="Direto_versus_propriedades_herdadas">Direto versus propriedades herdadas</h3> - -<p>O seguinte exemplo diferencia entre propriedades diretas e propriedades herdadas através da cadeia de protótipos:</p> - -<pre class="brush: js">o = new Object(); -o.prop = 'existe'; -o.hasOwnProperty('prop'); // retorna true -o.hasOwnProperty('toString'); // retorna false -o.hasOwnProperty('hasOwnProperty'); // retorna false -</pre> - -<h3 id="Iteração_entre_as_propriedades_de_um_objeto">Iteração entre as propriedades de um objeto</h3> - -<p>O seguinte exemplo mostra como iterar entre as propriedades de um objeto sem executar em propriedades herdadas. Note que o ciclo {{jsxref("Statements/for...in", "for...in")}} já está apenas repetindo itens enumeráveis então um não devia assumir baseado na falta de propriedades não-enumeráveis mostrado no ciclo que <code>hasOwnProperty</code> em si é estritamente limitado aos itens enumeráveis (como com {{jsxref("Object.getOwnPropertyNames()")}}).</p> - -<pre class="brush: js">var buz = { - fog: 'stack' -}; - -for (var name in buz) { - if (buz.hasOwnProperty(name)) { - console.log('Isto é fog (' + name + ') com certeza. Valor: ' + buz[name]); - } - else { - console.log(name); // toString ou outra coisa - } -} -</pre> - -<h3 id="Usando_hasOwnProperty_como_um_nome_de_uma_propriedade">Usando <code>hasOwnProperty</code> como um nome de uma propriedade</h3> - -<p>JavaScript não protege a propriedade <code>hasOwnProperty</code>; assim, se a possibilidade existe de um objeto poder ter uma propriedade com este nome, é necessário usar um <code>hasOwnProperty</code> externo para obter resultados corretos:</p> - -<pre class="brush: js">var foo = { - hasOwnProperty: function() { - return false; - }, - bar: 'Aqui os dragões' -}; - -foo.hasOwnProperty('bar'); // sempre retornará false - -// Use outro objeto hasOwnProperty e chame-o com 'this' definido como foo -({}).hasOwnProperty.call(foo, 'bar'); // true - -// É também possível usar a propriedade hasOwnProperty através do protótipo do objeto para este propósito -Object.prototype.hasOwnProperty.call(foo, 'bar'); // true -</pre> - -<p>Note que no último caso, não há objetos recém-criados.</p> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Definição inicial. Implementado em JavaScript 1.5.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.2.4.5', 'Object.prototype.hasOwnProperty')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-object.prototype.hasownproperty', 'Object.prototype.hasOwnProperty')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_entre_browsers">Compatibilidade entre browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Característica</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Característica</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Veja_também">Veja também</h2> - -<ul> - <li><a href="/en-US/docs/Enumerability_and_ownership_of_properties">Enumerabilidade e posse de propriedades</a></li> - <li>{{jsxref("Object.getOwnPropertyNames()")}}</li> - <li>{{jsxref("Statements/for...in", "for...in")}}</li> - <li>{{jsxref("Operators/in", "in")}}</li> - <li><a href="/en-US/docs/Web/JavaScript/Guide/Inheritance_Revisited">Guia JavaScript: Herança e a cadeia de protótipos</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/object/index.html b/files/pt-pt/web/javascript/reference/global_objects/object/index.html deleted file mode 100644 index e393f833b8..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/object/index.html +++ /dev/null @@ -1,184 +0,0 @@ ---- -title: Object -slug: Web/JavaScript/Reference/Global_Objects/Object -tags: - - Constructor - - Construtor - - JavaScript - - Object - - Objeto -translation_of: Web/JavaScript/Reference/Global_Objects/Object ---- -<div>{{JSRef}}</div> - -<p>o construtor <code><strong>Object</strong></code> cria um wrapper de objeto.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox">// Object initialiser or literal -{ [ <var>nameValuePair1</var>[, <var>nameValuePair2</var>[, ...<var>nameValuePairN</var>] ] ] } - -// Called as a constructor -new Object([<var>value</var>])</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>nameValuePair1, nameValuePair2, ... nameValuePair<em>N</em></code></dt> - <dd>Pairs of names (strings) and values (any value) where the name is separated from the value by a colon.</dd> - <dt><code>value</code></dt> - <dd>Any value.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>The <code>Object</code> constructor creates an object wrapper for the given value. If the value is {{jsxref("null")}} or {{jsxref("undefined")}}, it will create and return an empty object, otherwise, it will return an object of a Type that corresponds to the given value. If the value is an object already, it will return the value.</p> - -<p>When called in a non-constructor context, <code>Object</code> behaves identically to <code>new Object()</code>.</p> - -<p>See also the <a href="/en-US/docs/Web/JavaScript/Reference/Operators/Object_initializer">object initializer / literal syntax</a>.</p> - -<h2 id="Propriedades_de_um_construtor_Object">Propriedades de um construtor <code>Object</code></h2> - -<dl> - <dt><code>Object.length</code></dt> - <dd>Tem um valor de 1.</dd> - <dt>{{jsxref("Object.prototype")}}</dt> - <dd>Permite a adição de propriedades para todos os objetos do tipo <em>Object</em>.</dd> -</dl> - -<h2 id="Métodos_de_um_construtor_Object">Métodos de um construtor <code>Object</code></h2> - -<dl> - <dt>{{jsxref("Object.assign()")}}</dt> - <dd>Copies the values of all enumerable own properties from one or more source objects to a target object.</dd> - <dt>{{jsxref("Object.create()")}}</dt> - <dd>Creates a new object with the specified prototype object and properties.</dd> - <dt>{{jsxref("Object.defineProperty()")}}</dt> - <dd>Adds the named property described by a given descriptor to an object.</dd> - <dt>{{jsxref("Object.defineProperties()")}}</dt> - <dd>Adds the named properties described by the given descriptors to an object.</dd> - <dt>{{jsxref("Object.entries()")}}</dt> - <dd>Returns an array containing all of the <code>[key, value]</code> pairs of a given object's <strong>own</strong> enumerable string properties.</dd> - <dt>{{jsxref("Object.freeze()")}}</dt> - <dd>Freezes an object: other code can't delete or change any properties.</dd> - <dt>{{jsxref("Object.fromEntries()")}}</dt> - <dd>Returns a new object from an iterable of key-value pairs (reverses {{jsxref("Object.entries")}}).</dd> - <dt>{{jsxref("Object.getOwnPropertyDescriptor()")}}</dt> - <dd>Returns a property descriptor for a named property on an object.</dd> - <dt>{{jsxref("Object.getOwnPropertyDescriptors()")}}</dt> - <dd>Returns an object containing all own property descriptors for an object.</dd> - <dt>{{jsxref("Object.getOwnPropertyNames()")}}</dt> - <dd>Returns an array containing the names of all of the given object's <strong>own</strong> enumerable and non-enumerable properties.</dd> - <dt>{{jsxref("Object.getOwnPropertySymbols()")}}</dt> - <dd>Returns an array of all symbol properties found directly upon a given object.</dd> - <dt>{{jsxref("Object.getPrototypeOf()")}}</dt> - <dd>Returns the prototype of the specified object.</dd> - <dt>{{jsxref("Object.is()")}}</dt> - <dd>Compares if two values are the same value. Equates all NaN values (which differs from both Abstract Equality Comparison and Strict Equality Comparison).</dd> - <dt>{{jsxref("Object.isExtensible()")}}</dt> - <dd>Determines if extending of an object is allowed.</dd> - <dt>{{jsxref("Object.isFrozen()")}}</dt> - <dd>Determines if an object was frozen.</dd> - <dt>{{jsxref("Object.isSealed()")}}</dt> - <dd>Determines if an object is sealed.</dd> - <dt>{{jsxref("Object.keys()")}}</dt> - <dd>Returns an array containing the names of all of the given object's <strong>own</strong> enumerable string properties.</dd> - <dt>{{jsxref("Object.preventExtensions()")}}</dt> - <dd>Prevents any extensions of an object.</dd> - <dt>{{jsxref("Object.seal()")}}</dt> - <dd>Prevents other code from deleting properties of an object.</dd> - <dt>{{jsxref("Object.setPrototypeOf()")}}</dt> - <dd>Sets the prototype (i.e., the internal <code>[[Prototype]]</code> property).</dd> - <dt>{{jsxref("Object.values()")}}</dt> - <dd>Returns an array containing the values that correspond to all of a given object's <strong>own</strong> enumerable string properties.</dd> -</dl> - -<h2 id="Instâcias_de_Object_e_objeto_protótipo_Object">Instâcias de <code>Object</code> e objeto protótipo <code>Object</code></h2> - -<p>All objects in JavaScript are descended from <code>Object</code>; all objects inherit methods and properties from {{jsxref("Object.prototype")}}, although they may be overridden. For example, other constructors' prototypes override the <code>constructor</code> property and provide their own <code>toString()</code> methods. Changes to the <code>Object</code> prototype object are propagated to all objects unless the properties and methods subject to those changes are overridden further along the prototype chain.</p> - -<h3 id="Propriedades">Propriedades</h3> - -<div>{{page('//pt-PT/docs/Web/JavaScript/Reference/Global_Objects/Object/prototype', 'Propriedades') }}</div> - -<h3 id="Métodos">Métodos</h3> - -<div>{{page('//pt-PT/docs/Web/JavaScript/Reference/Global_Objects/Object/prototype', 'Métodos') }}</div> - -<h2 id="Deleting_a_property_from_an_object">Deleting a property from an object</h2> - -<p>There isn't any method in an Object itself to delete its own properties (e.g. like <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/delete">Map.prototype.delete()</a></code>). To do so one has to use the <a href="/en-US/docs/Web/JavaScript/Reference/Operators/delete">delete operator</a>.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Using_Object_given_undefined_and_null_types">Using <code>Object</code> given <code>undefined</code> and <code>null</code> types</h3> - -<p>The following examples store an empty <code>Object</code> object in <code>o</code>:</p> - -<pre class="brush: js">var o = new Object(); -</pre> - -<pre class="brush: js">var o = new Object(undefined); -</pre> - -<pre class="brush: js">var o = new Object(null); -</pre> - -<h3 id="Using_Object_to_create_Boolean_objects">Using <code>Object</code> to create <code>Boolean</code> objects</h3> - -<p>The following examples store {{jsxref("Boolean")}} objects in <code>o</code>:</p> - -<pre class="brush: js">// equivalent to o = new Boolean(true); -var o = new Object(true); -</pre> - -<pre class="brush: js">// equivalent to o = new Boolean(false); -var o = new Object(Boolean()); -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition. Implemented in JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.2', 'Object')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-object-objects', 'Object')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Added Object.assign, Object.getOwnPropertySymbols, Object.setPrototypeOf, Object.is</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-object-objects', 'Object')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Added Object.entries, Object.values and Object.getOwnPropertyDescriptors.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - -<div> - - -<p>{{Compat("javascript.builtins.Object")}}</p> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/pt-PT/docs/Web/JavaScript/Reference/Operadores/Inicializador_objeto">Inicializador de objeto</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/string/index.html b/files/pt-pt/web/javascript/reference/global_objects/string/index.html deleted file mode 100644 index 4ccc8f5f81..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/string/index.html +++ /dev/null @@ -1,326 +0,0 @@ ---- -title: String -slug: Web/JavaScript/Reference/Global_Objects/String -tags: - - ECMAScript 2015 - - JavaScript - - Referencia - - String -translation_of: Web/JavaScript/Reference/Global_Objects/String ---- -<div>{{JSRef}}</div> - -<p>O objeto global <strong><code>String</code></strong> é um construtor de <em>strings</em> ou sequência de carateres.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<p>Os literais de string assumem as formas:</p> - -<pre class="syntaxbox"><code>'string text' -"string text" -"中文 español English हिन्दी العربية português বাংলা русский 日本語 ਪੰਜਾਬੀ 한국어 தமிழ்"</code></pre> - -<p>As Strings podem também ser criadas usando o objecto global string directamente:</p> - -<pre class="syntaxbox"><code>String(thing) -new String(thing)</code></pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>thing</code></dt> - <dd>Qualquer parâmetro para ser convertido numa <em>string</em>.</dd> -</dl> - -<h3 id="Strings_modelo"><em>Strings </em>modelo</h3> - -<p>A partir de ECMAScript 2015, os literais de <em>strings</em> podem também ser chamados de <a href="/en-US/docs/Web/JavaScript/Reference/template_strings">Modelo strings</a>:</p> - -<pre class="brush: js"><code>`hello world`</code> -`hello! - world!` -<code>`hello ${who}`</code> -<code>escape `<a>${who}</a>`</code></pre> - -<dl> -</dl> - -<h3 id="Notação_Escape">Notação <em>Escape</em></h3> - -<p>Além dos carateres regulares e imprmiveis, os carateres especiais também podem ser codificados com notação <em>escape</em>:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Código</th> - <th scope="col">Resultado</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>\XXX</code> (<code>XXX</code> = 1 - 3 octal digits; range of 0 - 377)</td> - <td>ISO-8859-1 character / Unicode code point between U+0000 and U+00FF</td> - </tr> - <tr> - <td><code>\'</code></td> - <td>Aspas simples</td> - </tr> - <tr> - <td><code>\"</code></td> - <td>Aspas duplas</td> - </tr> - <tr> - <td><code>\\</code></td> - <td>Barra invertida</td> - </tr> - <tr> - <td><code>\n</code></td> - <td>Nova linha</td> - </tr> - <tr> - <td><code>\r</code></td> - <td>carriage return</td> - </tr> - <tr> - <td><code>\v</code></td> - <td>Tab vertical</td> - </tr> - <tr> - <td><code>\t</code></td> - <td>Tab</td> - </tr> - <tr> - <td><code>\b</code></td> - <td>backspace</td> - </tr> - <tr> - <td><code>\f</code></td> - <td>form feed</td> - </tr> - <tr> - <td><code>\uXXXX</code> (<code>XXXX</code> = 4 hex digits; range of 0x0000 - 0xFFFF)</td> - <td>UTF-16 code unit / Unicode code point between U+0000 and U+FFFF</td> - </tr> - <tr> - <td><code>\u{X}</code> ... <code>\u{XXXXXX}</code> (<code>X…XXXXXX</code> = 1 - 6 hex digits; range of 0x0 - 0x10FFFF)</td> - <td>UTF-32 code unit / Unicode code point between U+0000 and U+10FFFF {{experimental_inline}}</td> - </tr> - <tr> - <td><code>\xXX</code> (<code>XX</code> = 2 hex digits; range of 0x00 - 0xFF)</td> - <td>ISO-8859-1 character / Unicode code point between U+0000 and U+00FF</td> - </tr> - </tbody> -</table> - -<div class="note"> -<p><strong>Note: </strong>Ao contrário de algumas outras linguagens, o Javascript não faz distinção entre strings com aspas simples e aspas duplas; Portanto a notação "escape" funciona em strings independente se foi utilizada aspas simples, ou aspas duplas na criação.</p> -</div> - -<h3 id="Strings_literais_longas"><em>Strings </em>literais longas</h3> - -<p>Sometimes, your code will include strings which are very long. Rather than having lines that go on endlessly, or wrap at the whim of your editor, you may wish to specifically break the string into multiple lines in the source code without affecting the actual string contents. There are two ways you can do this.</p> - -<p>You can use the <a href="/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators#Addition_()">+</a> operator to append multiple strings together, like this:</p> - -<pre class="brush: js">let longString = "This is a very long string which needs " + - "to wrap across multiple lines because " + - "otherwise my code is unreadable."; -</pre> - -<p>Or you can use the backslash character ("\") at the end of each line to indicate that the string will continue on the next line. Make sure there is no space or any other character after the backslash (except for a line break), or as an indent; otherwise it will not work. That form looks like this:</p> - -<pre class="brush: js">let longString = "This is a very long string which needs \ -to wrap across multiple lines because \ -otherwise my code is unreadable."; -</pre> - -<p>Both of these result in identical strings being created.</p> - -<h2 id="Descrição">Descrição</h2> - -<p>Strings are useful for holding data that can be represented in text form. Some of the most-used operations on strings are to check their {{jsxref("String.length", "length")}}, to build and concatenate them using the <a href="/en-US/docs/Web/JavaScript/Reference/Operators/String_Operators">+ and += string operators</a>, checking for the existence or location of substrings with the {{jsxref("String.prototype.indexOf()", "indexOf()")}} method, or extracting substrings with the {{jsxref("String.prototype.substring()", "substring()")}} method.</p> - -<h3 id="Acesso_de_caráter">Acesso de caráter</h3> - -<p>There are two ways to access an individual character in a string. The first is the {{jsxref("String.prototype.charAt()", "charAt()")}} method:</p> - -<pre class="brush: js">return 'cat'.charAt(1); // returns "a" -</pre> - -<p>The other way (introduced in ECMAScript 5) is to treat the string as an array-like object, where individual characters correspond to a numerical index:</p> - -<pre class="brush: js">return 'cat'[1]; // returns "a" -</pre> - -<p>For character access using bracket notation, attempting to delete or assign a value to these properties will not succeed. The properties involved are neither writable nor configurable. (See {{jsxref("Object.defineProperty()")}} for more information.)</p> - -<h3 id="Comparação_de_strings">Comparação de <em>strings</em></h3> - -<p>C developers have the <code>strcmp()</code> function for comparing strings. In JavaScript, you just use the <a href="/en-US/docs/Web/JavaScript/Reference/Operators/Comparison_Operators">less-than and greater-than operators</a>:</p> - -<pre class="brush: js">var a = 'a'; -var b = 'b'; -if (a < b) { // true - console.log(a + ' is less than ' + b); -} else if (a > b) { - console.log(a + ' is greater than ' + b); -} else { - console.log(a + ' and ' + b + ' are equal.'); -} -</pre> - -<p>A similar result can be achieved using the {{jsxref("String.prototype.localeCompare()", "localeCompare()")}} method inherited by <code>String</code> instances.</p> - -<h3 id="Distinção_entre_string_primitivas_e_objetos_String">Distinção entre <em>string</em> primitivas e objetos <em><code>String</code></em></h3> - -<p>Note that JavaScript distinguishes between <code>String</code> objects and primitive string values. (The same is true of {{jsxref("Boolean")}} and {{jsxref("Global_Objects/Number", "Numbers")}}.)</p> - -<p>String literals (denoted by double or single quotes) and strings returned from <code>String</code> calls in a non-constructor context (i.e., without using the {{jsxref("Operators/new", "new")}} keyword) are primitive strings. JavaScript automatically converts primitives to <code>String</code> objects, so that it's possible to use <code>String</code> object methods for primitive strings. In contexts where a method is to be invoked on a primitive string or a property lookup occurs, JavaScript will automatically wrap the string primitive and call the method or perform the property lookup.</p> - -<pre class="brush: js">var a = 'a'; -var b = 'b'; -if (a < b) { // true - console.log(a + ' is less than ' + b); -} else if (a > b) { - console.log(a + ' is greater than ' + b); -} else { - console.log(a + ' and ' + b + ' are equal.'); -} -</pre> - -<p>A similar result can be achieved using the {{jsxref("String.prototype.localeCompare()", "localeCompare()")}} method inherited by <code>String</code> instances.</p> - -<div class="blockIndicator note"> -<p>Nota: <code>a == b</code> compares the strings in a and b for being equal in the usual case-sensitive way. If you wish to compare without regard to upper or lower case characters, use a function similar to this:</p> - -<p><code>function isEqual(str1, str2)<br> - {<br> - return str1.toUpperCase()===str2.toUpperCase();<br> - } // isEqual</code></p> - -<p>Upper case is used instead of lower case in this function due to problems with certain UTF-8 character conversions.</p> -</div> - -<h3 id="Distinção_entre_string_primitivas_e_objetos_String_2">Distinção entre <em>string</em> primitivas e objetos <em><code>String</code></em></h3> - -<p>Note that JavaScript distinguishes between <code>String</code> objects and primitive string values. (The same is true of {{jsxref("Boolean")}} and {{jsxref("Global_Objects/Number", "Numbers")}}.)</p> - -<p>String literals (denoted by double or single quotes) and strings returned from <code>String</code> calls in a non-constructor context (i.e., without using the {{jsxref("Operators/new", "new")}} keyword) are primitive strings. JavaScript automatically converts primitives to <code>String</code> objects, so that it's possible to use <code>String</code> object methods for primitive strings. In contexts where a method is to be invoked on a primitive string or a property lookup occurs, JavaScript will automatically wrap the string primitive and call the method or perform the property lookup.</p> - -<pre class="brush: js">var s_prim = 'foo'; -var s_obj = new String(s_prim); - -console.log(typeof s_prim); // Logs "string" -console.log(typeof s_obj); // Logs "object" -</pre> - -<p>String primitives and <code>String</code> objects also give different results when using {{jsxref("Global_Objects/eval", "eval()")}}. Primitives passed to <code>eval</code> are treated as source code; <code>String</code> objects are treated as all other objects are, by returning the object. For example:</p> - -<pre class="brush: js">var s1 = '2 + 2'; // creates a string primitive -var s2 = new String('2 + 2'); // creates a String object -console.log(eval(s1)); // returns the number 4 -console.log(eval(s2)); // returns the string "2 + 2" -</pre> - -<p>For these reasons, the code may break when it encounters <code>String</code> objects when it expects a primitive string instead, although generally, authors need not worry about the distinction.</p> - -<p>A <code>String</code> object can always be converted to its primitive counterpart with the {{jsxref("String.prototype.valueOf()", "valueOf()")}} method.</p> - -<pre class="brush: js">console.log(eval(s2.valueOf())); // returns the number 4 -</pre> - -<div class="note"><strong>Nota:</strong> For another possible approach to strings in JavaScript, please read the article about <a href="/en-US/Add-ons/Code_snippets/StringView"><code>StringView</code> — a C-like representation of strings based on typed arrays</a>.</div> - -<h2 id="Propriedades">Propriedades</h2> - -<dl> - <dt>{{jsxref("String.prototype")}}</dt> - <dd>Allows the addition of properties to a <code>String</code> object.</dd> -</dl> - -<h2 id="Métodos">Métodos</h2> - -<dl> - <dt>{{jsxref("String.fromCharCode()")}}</dt> - <dd>Returns a string created by using the specified sequence of Unicode values.</dd> - <dt>{{jsxref("String.fromCodePoint()")}}</dt> - <dd>Returns a string created by using the specified sequence of code points.</dd> - <dt>{{jsxref("String.raw()")}} {{experimental_inline}}</dt> - <dd>Returns a string created from a raw template string.</dd> -</dl> - -<h2 id="Instâncias_de_String">Instâncias de <em><code>String</code></em></h2> - -<h3 id="Propriedades_2">Propriedades</h3> - -<div>{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/prototype', 'Properties')}}</div> - -<h3 id="Métodos_2">Métodos</h3> - -<h4 id="Methods_unrelated_to_HTML">Methods unrelated to HTML</h4> - -<div>{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/prototype', 'Methods_unrelated_to_HTML')}}</div> - -<h4 id="HTML_wrapper_methods">HTML wrapper methods</h4> - -<div>{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/prototype', 'HTML_wrapper_methods')}}</div> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Conversão_de_String">Conversão de <em>String</em></h3> - -<p>It's possible to use <code>String</code> as a more reliable {{jsxref("String.prototype.toString()", "toString()")}} alternative, as it works when used on {{jsxref("null")}}, {{jsxref("undefined")}}, and on {{jsxref("Symbol", "symbols")}}. For example:</p> - -<pre class="brush: js">var outputStrings = []; -for (var i = 0, n = inputValues.length; i < n; ++i) { - outputStrings.push(String(inputValues[i])); -} -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('ESDraft', '#sec-string-objects', 'String')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-string-objects', 'String')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.5', 'String')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - - - -<p>{{Compat("javascript.builtins.String",2)}}</p> - -<h2 id="Consulte_também">Consulte também:</h2> - -<ul> - <li>{{domxref("DOMString")}}</li> - <li><a href="/en-US/Add-ons/Code_snippets/StringView"><code>StringView</code> — a C-like representation of strings based on typed arrays</a></li> - <li><a href="/en-US/docs/Web/API/DOMString/Binary">Binary strings</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/string/indexof/index.html b/files/pt-pt/web/javascript/reference/global_objects/string/indexof/index.html deleted file mode 100644 index 721fb3c913..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/string/indexof/index.html +++ /dev/null @@ -1,191 +0,0 @@ ---- -title: String.prototype.indexOf() -slug: Web/JavaScript/Reference/Global_Objects/String/indexOf -tags: - - JavaScript - - Method - - Prototype - - Reference - - String -translation_of: Web/JavaScript/Reference/Global_Objects/String/indexOf ---- -<div>{{JSRef}}</div> - -<p>O método <strong><code>indexOf()</code></strong> retorna o indíce da primeira ocorrência do valor especificado no objeto {{jsxref("String")}}, começando a procura a partir de <code>fromIndex</code>. Retorna -1 se o valor não for encontrado.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><code><var>str</var>.indexOf(<var>searchValue</var>[, <var>fromIndex</var>]</code>)</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>searchValue</code></dt> - <dd>Uma string com o valor pelo qual se procura.</dd> - <dt><code>fromIndex</code> {{optional_inline}}</dt> - <dd>O ponto da string a partir do qual a procura deverá começar. Pode ter o valor de um qualquer inteiro. O valor por predefinição é 0. Se o <code>fromIndex < 0</code> a procura é feita em toda a string (o mesmo que passar o valor 0). Se <code>fromIndex >= str.length</code>, o método retornará -1, exceção feita quando o valor de <code>searchValue</code> é uma string vazia, nesse caso retorna <code>str.length</code>.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>Os caractéres numa string são indexadas da esquerda para a direita. O índice do primeira caractér é 0, e o índice do último caractér da string, chamado de <code>stringName,</code> é <code>stringName.length - 1</code>.</p> - -<pre class="brush: js">'Blue Whale'.indexOf('Blue'); // retorna 0 -'Blue Whale'.indexOf('Blute'); // retorna -1 -'Blue Whale'.indexOf('Whale', 0); // retorna 5 -'Blue Whale'.indexOf('Whale', 5); // retorna 5 -'Blue Whale'.indexOf('', 9); // retorna 9 -'Blue Whale'.indexOf('', 10); // retorna 10 -'Blue Whale'.indexOf('', 11); // retorna 10 -</pre> - -<h3 id="Case-sensitivity">Case-sensitivity</h3> - -<p>O método <code>indexOf()</code> é sensível a maiúsculas e minúsculas. Por exemplo, a seguinte expressão retorna -1:</p> - -<pre class="brush: js">'Blue Whale'.indexOf('blue'); // retorna -1 -</pre> - -<h3 id="Verificando_ocorrências">Verificando ocorrências</h3> - -<p>Repara que '0' não é avaliado como <code>true</code> e '-1' não é avaliado como <code>false</code>. Sendo assim, a forma correta de verificar se uma string específica existe dentro de outra string deverá ser:</p> - -<pre class="brush: js">'Blue Whale'.indexOf('Blue') !== -1; // true -'Blue Whale'.indexOf('Bloe') !== -1; // false -</pre> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Usando_indexOf()_e_lastIndexOf()">Usando <code>indexOf()</code> e <code>lastIndexOf()</code></h3> - -<p>O seguinte exemplo usa <code>indexOf()</code> e {{jsxref("String.prototype.lastIndexOf()", "lastIndexOf()")}} para localizar valores na string <code>"Brave new world"</code>.</p> - -<pre class="brush: js">var anyString = 'Brave new world'; - -console.log('O índice do primeiro w desde o início é ' + anyString.indexOf('w')); -// imprime 8 -console.log('O índice do primeiro w desde o fim é ' + anyString.lastIndexOf('w')); -// imprime 10 - -console.log('O índice de "new" desde o início é ' + anyString.indexOf('new')); -// imprime 6 -console.log('O índice de "new" desde o fim é ' + anyString.lastIndexOf('new')); -// imprime 6 -</pre> - -<h3 id="indexOf()_e_sensibilidade_a_maiúsculas_e_minúsculas"><code>indexOf()</code> e sensibilidade a maiúsculas e minúsculas</h3> - -<p>O seguinte exemplo define duas variáveis do tipo string. As variáveis contêm a mesma string exceto o facto da segunda string conter as todas as letras maiúsculas. O primeiro método {{domxref("console.log()")}} apresenta 19. Mas porque o método <code>indexOf()</code> é sensível a maiúsculas e minúsculas, a string <code>"cheddar"</code> não é encontrada em <code>myCapString</code>, logo o segundo método <code>console.log()</code> apresenta -1.</p> - -<pre class="brush: js">var myString = 'brie, pepper jack, cheddar'; -var myCapString = 'Brie, Pepper Jack, Cheddar'; - -console.log('myString.indexOf("cheddar") é ' + myString.indexOf('cheddar')); -// imprime 19 -console.log('myCapString.indexOf("cheddar") é ' + myCapString.indexOf('cheddar')); -// imprime -1 -</pre> - -<h3 id="Usando_indexOf()_para_contar_as_ocorrências_de_uma_letra_numa_string">Usando <code>indexOf()</code> para contar as ocorrências de uma letra numa string</h3> - -<p>O seguinte exemplo atribuí à variável <code>count</code> o número de ocorrências da letra 'e' na string <code>str</code>:</p> - -<pre class="brush: js">var str = 'To be, or not to be, that is the question.'; -var count = 0; -var pos = str.indexOf('e'); - -while (pos !== -1) { - count++; - pos = str.indexOf('e', pos + 1); -} - -console.log(count); // imprime 4 -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Definição inicial.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.5.4.7', 'String.prototype.indexOf')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-string.prototype.indexof', 'String.prototype.indexOf')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{jsxref("String.prototype.charAt()")}}</li> - <li>{{jsxref("String.prototype.lastIndexOf()")}}</li> - <li>{{jsxref("String.prototype.split()")}}</li> - <li>{{jsxref("Array.prototype.indexOf()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/string/length/index.html b/files/pt-pt/web/javascript/reference/global_objects/string/length/index.html deleted file mode 100644 index 7774170252..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/string/length/index.html +++ /dev/null @@ -1,125 +0,0 @@ ---- -title: String.length -slug: Web/JavaScript/Reference/Global_Objects/String/length -tags: - - JavaScript - - Property - - Prototype - - Reference - - String -translation_of: Web/JavaScript/Reference/Global_Objects/String/length ---- -<div>{{JSRef}}</div> - -<p>A propriedade <strong><code>length</code></strong> representa o comprimento de uma string.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><code><var>str</var>.length</code></pre> - -<h2 id="Descrição">Descrição</h2> - -<p>Esta propriedade retorna o número de code units na string. {{interwiki("wikipedia", "UTF-16")}}, o formato usado pelo JavaScript para a string, usa um single 16-bit code unit para representar os caracteres mais comuns, mas necessita de usar two code units para os caracteres menos comuns, pelo que é possível que o valor retornado por <code>length</code> não seja igual ao número de caracteres numa string.</p> - -<p>Para uma string vazia, <code>length</code> is 0.</p> - -<p>A propriedade estática (static) <code>String.length</code> retorna o valor 1.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Uso_simples">Uso simples</h3> - -<pre class="brush: js">var x = 'Mozilla'; -var empty = ''; - -console.log('Mozilla tem de tamanho ' + x.length + ' code units'); -/* "Mozilla tem de tamanho 7 code units" */ - -console.log('Uma string vazia tem tamanho ' + empty.length); -/* "Uma string vazia tem tamanho 0" */ -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Definição inicial. Implementado em JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.5.5.1', 'String.prototype.length')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-properties-of-string-instances-length', 'String.prototype.length')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li><a href="http://developer.teradata.com/blog/jasonstrimpel/2011/11/javascript-string-length-and-internationalizing-web-applications">JavaScript <code>String.length</code> and Internationalizing Web Applications</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/string/trim/index.html b/files/pt-pt/web/javascript/reference/global_objects/string/trim/index.html deleted file mode 100644 index 8ef29112f8..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/string/trim/index.html +++ /dev/null @@ -1,139 +0,0 @@ ---- -title: String.prototype.trim() -slug: Web/JavaScript/Reference/Global_Objects/String/Trim -tags: - - ECMAScript 5 - - JavaScript - - Prototipo - - Referencia - - String - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/String/Trim ---- -<div>{{JSRef}}</div> - -<p>O método <strong><code>trim()</code></strong> elimina espaço em branco de ambos os extremos dum <em>string</em>. Espaço em branco neste contexto são todos os caracteres que apenas representam espaço (espaço, tabulação, espaço fixo, etc.) e todos os caracteres que representam limites de linha (LF, CR, etc.).</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><code><var>str</var>.trim()</code></pre> - -<h3 id="Valor_devolvido">Valor devolvido</h3> - -<p>Um novo <em>string</em> que representa o <em>string</em> que chamou despojado do espaço em branco de ambos os extremos.</p> - -<h2 id="Descrição">Descrição</h2> - -<p>O método <code>trim()</code> devolve o <em>string</em> despojado do espaço em branco de ambos os extremos. <code>trim()</code> não afecta o valor do <em>string</em> em si.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Using_trim()">Using <code>trim()</code></h3> - -<p>O exemplo que se segue mostra o <em>string</em> <code>'foo' em minúsculas</code>:</p> - -<pre class="brush: js">var orig = ' foo '; -console.log(orig.trim()); // 'foo' - -// Outro exemplo de .trim() eliminando espaço em branco de apenas um lado. - -var orig = 'foo '; -console.log(orig.trim()); // 'foo' -</pre> - -<h2 id="Polyfill">Polyfill</h2> - -<p>Ao correr o código que se segue antes de qualquer outro criará <code>trim()</code> se não estiver nativamente disponível.</p> - -<pre class="brush: js">if (!String.prototype.trim) { - String.prototype.trim = function () { - return this.replace(/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, ''); - }; -} -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.5.4.20', 'String.prototype.trim')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Definição inicial. Implementada em JavaScript 1.8.1.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-string.prototype.trim', 'String.prototype.trim')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-string.prototype.trim', 'String.prototype.trim')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegadores">Compatibilidade de navegadores</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Característica</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatGeckoDesktop("1.9.1")}}</td> - <td>{{CompatIE("9")}}</td> - <td>{{CompatOpera("10.5")}}</td> - <td>{{CompatSafari("5")}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Característica</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Ver_também">Ver também</h2> - -<ul> - <li>{{jsxref("String.prototype.trimLeft()")}} {{non-standard_inline}}</li> - <li>{{jsxref("String.prototype.trimRight()")}} {{non-standard_inline}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/symbol/hasinstance/index.html b/files/pt-pt/web/javascript/reference/global_objects/symbol/hasinstance/index.html deleted file mode 100644 index 3ba9666678..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/symbol/hasinstance/index.html +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: Symbol.hasInstance -slug: Web/JavaScript/Reference/Global_Objects/Symbol/hasInstance -tags: - - Propriedade - - Referencia -translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/hasInstance ---- -<div>{{JSRef}}</div> - -<p>O symbol bem-conhecido <strong><code>Symbol.hasInstance</code></strong> é usado para determinar se um objecto construtor reconhece um objecto como de sua instância. O comportamento do operador {{jsxref("Operators/instanceof", "instanceof")}} pode ser customizado por este symbol.</p> - -<div>{{js_property_attributes(0,0,0)}}</div> - -<h2 id="Exemplos">Exemplos</h2> - -<p>Tu podes implementar o comportamento customizado do seu <code>instanceof</code> deste jeito; por exemplo:</p> - -<pre class="brush: js">class MyArray { - static [Symbol.hasInstance](instance) { - return this.prototype.isPrototypeOf(instance) || - Array.isArray(instance); - } -} - -console.log([] instanceof MyArray); // true -console.log(new MyArray instanceof MyArray); // true -console.log(new Image instanceof MyArray); // false - -class MySubArray extends MyArray {} -console.log(new MySubArray instanceof MySubArray); // true -console.log(new MySubArray instanceof MyArray); // true -console.log(new MyArray instanceof MySubArray); // false</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-symbol.hasinstance', 'Symbol.hasInstance')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-symbol.hasinstance', 'Symbol.hasInstance')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_com_os_navegadores">Compatibilidade com os navegadores</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatChrome(51)}}</td> - <td>{{ CompatGeckoDesktop(50) }}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{ CompatGeckoMobile(50) }}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Veja_também">Veja também</h2> - -<ul> - <li>{{jsxref("Operators/instanceof", "instanceof")}}</li> - <li>{{jsxref("Global_Objects/Object/isPrototypeOf", "isPrototypeOf()")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/global_objects/symbol/index.html b/files/pt-pt/web/javascript/reference/global_objects/symbol/index.html deleted file mode 100644 index 00148cd9b1..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/symbol/index.html +++ /dev/null @@ -1,458 +0,0 @@ ---- -title: Symbol -slug: Web/JavaScript/Reference/Global_Objects/Symbol -tags: - - ECMAScript6 - - JavaScript - - NeedsTranslation - - Symbol - - TopicStub -translation_of: Web/JavaScript/Reference/Global_Objects/Symbol ---- -<div>{{JSRef}}</div> - -<p>A <strong>symbol</strong> is a unique and immutable data type. It may be used as an identifier for object properties. The <em>Symbol object</em> is an implicit object wrapper for the symbol {{Glossary("Primitive", "primitive data type")}}.</p> - -<h2 id="Syntax">Syntax</h2> - -<pre class="syntaxbox">Symbol(<em>[description]</em>)</pre> - -<h3 id="Parameters">Parameters</h3> - -<dl> - <dt><code>description</code> {{optional_inline}}</dt> - <dd>Optional, string. A description of the symbol which can be used for debugging but not to access the symbol itself.</dd> -</dl> - -<h2 id="Description">Description</h2> - -<p>To create a new primitive symbol, you write <code>Symbol()</code> with an optional string as its description:</p> - -<pre class="brush: js">var sym1 = Symbol(); -var sym2 = Symbol("foo"); -var sym3 = Symbol("foo"); -</pre> - -<p>The above code creates three new symbols. Note that <code>Symbol("foo")</code> does not coerce the string "foo" into a symbol. It creates a new symbol each time:</p> - -<pre class="brush: js">Symbol("foo") === Symbol("foo"); // false</pre> - -<p>The following syntax with the {{jsxref("Operators/new", "new")}} operator will throw a {{jsxref("TypeError")}}:</p> - -<pre class="brush: js">var sym = new Symbol(); // TypeError</pre> - -<p>This prevents authors from creating an explicit <code>Symbol</code> wrapper object instead of a new symbol value and might be surprising as creating explicit wrapper objects around primitive data types is generally possible (for example, <code>new Boolean</code>, <code>new String</code> and <code>new Number</code>).</p> - -<p>If you really want to create a <code>Symbol</code> wrapper object, you can use the <code>Object()</code> function:</p> - -<pre class="brush: js">var sym = Symbol("foo"); -typeof sym; // "symbol" -var symObj = Object(sym); -typeof symObj; // "object" -</pre> - -<h3 id="Shared_symbols_in_the_global_symbol_registry">Shared symbols in the global symbol registry</h3> - -<p>The above syntax using the <code>Symbol()</code> function will not create a global symbol that is available in your whole codebase. To create symbols available across files and even across realms (each of which has its own global scope), use the methods {{jsxref("Symbol.for()")}} and {{jsxref("Symbol.keyFor()")}} to set and retrieve symbols from the global symbol registry.</p> - -<h3 id="Finding_symbol_properties_on_objects">Finding symbol properties on objects</h3> - -<p>The method {{jsxref("Object.getOwnPropertySymbols()")}} returns an array of symbols and lets you find symbol properties on a given object. Note that every object is initialized with no own symbol properties, so that this array will be empty unless you've set symbol properties on the object.</p> - -<h2 id="Properties">Properties</h2> - -<dl> - <dt><code>Symbol.length</code></dt> - <dd>Length property whose value is 0.</dd> - <dt>{{jsxref("Symbol.prototype")}}</dt> - <dd>Represents the prototype for the <code>Symbol</code> constructor.</dd> -</dl> - -<h3 id="Well-known_symbols">Well-known symbols</h3> - -<p>In addition to your own symbols, JavaScript has some built-in symbols which represent internal language behaviors which were not exposed to developers in ECMAScript 5 and before. These symbols can be accessed using the following properties:</p> - -<h4 id="Iteration_symbols">Iteration symbols</h4> - -<dl> - <dt>{{jsxref("Symbol.iterator")}}</dt> - <dd>A method returning the default iterator for an object. Used by <a href="/en-US/docs/Web/JavaScript/Reference/Statements/for...of"><code>for...of</code></a>.</dd> -</dl> - -<h4 id="Regular_expression_symbols">Regular expression symbols</h4> - -<dl> - <dt>{{jsxref("Symbol.match")}}</dt> - <dd>A method that matches against a string, also used to determine if an object may be used as a regular expression. Used by {{jsxref("String.prototype.match()")}}.</dd> - <dt>{{jsxref("Symbol.replace")}}</dt> - <dd>A method that replaces matched substrings of a string. Used by {{jsxref("String.prototype.replace()")}}.</dd> - <dt>{{jsxref("Symbol.search")}}</dt> - <dd>A method that returns the index within a string that matches the regular expression. Used by {{jsxref("String.prototype.search()")}}.</dd> - <dt>{{jsxref("Symbol.split")}}</dt> - <dd>A method that splits a string at the indices that match a regular expression. Used by {{jsxref("String.prototype.split()")}}.</dd> -</dl> - -<h4 id="Other_symbols">Other symbols</h4> - -<dl> - <dt>{{jsxref("Symbol.hasInstance")}}</dt> - <dd>A method determining if a constructor object recognizes an object as its instance. Used by {{jsxref("Operators/instanceof", "instanceof")}}.</dd> - <dt>{{jsxref("Symbol.isConcatSpreadable")}}</dt> - <dd>A Boolean value indicating if an object should be flattened to its array elements. Used by {{jsxref("Array.prototype.concat()")}}.</dd> - <dt>{{jsxref("Symbol.unscopables")}}</dt> - <dd>An object value of whose own and inherited property names are excluded from the <code><a href="/en-US/docs/Web/JavaScript/Reference/Statements/with">with</a></code> environment bindings of the associated object.</dd> - <dt>{{jsxref("Symbol.species")}}</dt> - <dd>A constructor function that is used to create derived objects.</dd> - <dt>{{jsxref("Symbol.toPrimitive")}}</dt> - <dd>A method converting an object to a primitive value.</dd> - <dt>{{jsxref("Symbol.toStringTag")}}</dt> - <dd>A string value used for the default description of an object. Used by {{jsxref("Object.prototype.toString()")}}.</dd> -</dl> - -<h2 id="Methods">Methods</h2> - -<dl> - <dt>{{jsxref("Symbol.for()", "Symbol.for(key)")}}</dt> - <dd>Searches for existing symbols with the given key and returns it if found. Otherwise a new symbol gets created in the global symbol registry with this key.</dd> - <dt>{{jsxref("Symbol.keyFor", "Symbol.keyFor(sym)")}}</dt> - <dd>Retrieves a shared symbol key from the global symbol registry for the given symbol.</dd> -</dl> - -<h2 id="Symbol_prototype"><code>Symbol</code> prototype</h2> - -<p>All Symbols inherit from {{jsxref("Symbol.prototype")}}.</p> - -<h3 id="Properties_2">Properties</h3> - -<p>{{page('en-US/Web/JavaScript/Reference/Global_Objects/Symbol/prototype','Properties')}}</p> - -<h3 id="Methods_2">Methods</h3> - -<p>{{page('en-US/Web/JavaScript/Reference/Global_Objects/Symbol/prototype','Methods')}}</p> - -<h2 id="Examples">Examples</h2> - -<h3 id="Using_the_typeof_operator_with_symbols">Using the <code>typeof</code> operator with symbols</h3> - -<p>The {{jsxref("Operators/typeof", "typeof")}} operator can help you to identify symbols.</p> - -<pre class="brush: js">typeof Symbol() === 'symbol' -typeof Symbol('foo') === 'symbol' -typeof Symbol.iterator === 'symbol' -</pre> - -<h3 id="Symbol_type_conversions">Symbol type conversions</h3> - -<p>Some things to note when working with type conversion of symbols.</p> - -<ul> - <li>When trying to convert a symbol to a number, a {{jsxref("TypeError")}} will be thrown<br> - (e.g. <code>+sym</code> or <code>sym | 0</code>).</li> - <li>When using loose equality, <code>Object(sym) == sym</code> returns <code>true.</code></li> - <li><code>Symbol("foo") + "bar" </code>throws a {{jsxref("TypeError")}} (can't convert symbol to string). This prevents you from silently creating a new string property name from a symbol, for example.</li> - <li>The <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/String#String_conversion">"safer" <code>String(sym)</code> conversion</a> works like a call to {{jsxref("Symbol.prototype.toString()")}} with symbols, but note that <code>new String(sym)</code> will throw.</li> -</ul> - -<h3 id="Symbols_and_for...in_iteration">Symbols and <code>for...in</code> iteration</h3> - -<p>Symbols are not enumerable in <a href="/en-US/docs/Web/JavaScript/Reference/Statements/for...in"><code>for...in</code></a> iterations. In addition, {{jsxref("Object.getOwnPropertyNames()")}} will not return symbol object properties, however, you can use {{jsxref("Object.getOwnPropertySymbols()")}} to get these.</p> - -<pre class="brush: js">var obj = {}; - -obj[Symbol("a")] = "a"; -obj[Symbol.for("b")] = "b"; -obj["c"] = "c"; -obj.d = "d"; - -for (var i in obj) { - console.log(i); // logs "c" and "d" -}</pre> - -<h3 id="Symbols_and_JSON.stringify()">Symbols and <code>JSON.stringify()</code></h3> - -<p>Symbol-keyed properties will be completely ignored when using <code>JSON.stringify()</code>:</p> - -<pre class="brush: js">JSON.stringify({[Symbol("foo")]: "foo"}); -// '{}'</pre> - -<p>For more details, see {{jsxref("JSON.stringify()")}}.</p> - -<h3 id="Symbol_wrapper_objects_as_property_keys">Symbol wrapper objects as property keys</h3> - -<p>When a Symbol wrapper object is used as a property key, this object will be coerced to its wrapped symbol:</p> - -<pre class="brush: js">var sym = Symbol("foo"); -var obj = {[sym]: 1}; -obj[sym]; // 1 -obj[Object(sym)]; // still 1 -</pre> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-symbol-objects', 'Symbol')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Initial definition</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-symbol-objects', 'Symbol')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatChrome(38)}}</td> - <td>{{CompatGeckoDesktop(36)}}</td> - <td>{{CompatNo}}</td> - <td>25</td> - <td>9</td> - </tr> - <tr> - <td>Symbol.iterator (@@iterator)</td> - <td>{{CompatChrome(38)}}</td> - <td>{{CompatGeckoDesktop(36)}}</td> - <td>{{CompatNo}}</td> - <td>25</td> - <td>9</td> - </tr> - <tr> - <td>Symbol.unscopables (@@unscopables)</td> - <td>{{CompatChrome(38)}}</td> - <td>{{CompatGeckoDesktop(48)}}</td> - <td>{{CompatNo}}</td> - <td>25</td> - <td>9</td> - </tr> - <tr> - <td>Symbol.match (@@match)</td> - <td>{{CompatChrome(50)}}</td> - <td>{{CompatGeckoDesktop(40)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.species (@@species)</td> - <td>{{CompatChrome(51)}}</td> - <td>{{CompatGeckoDesktop(41)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.toPrimitive (@@toPrimitive)</td> - <td>{{CompatChrome(48)}}</td> - <td>{{CompatGeckoDesktop(44)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.replace (@@replace)</td> - <td>{{CompatChrome(50)}}</td> - <td>{{CompatGeckoDesktop(48)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.search (@@search)</td> - <td>{{CompatChrome(50)}}</td> - <td>{{CompatGeckoDesktop(48)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.split (@@split)</td> - <td>{{CompatChrome(50)}}</td> - <td>{{CompatGeckoDesktop(48)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.isConcatSpreadable (@@isconcatspreadable)</td> - <td>{{CompatChrome(48)}}</td> - <td>{{CompatGeckoDesktop(48)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.hasInstance (@@hasInstance)</td> - <td>{{CompatChrome(51)}}</td> - <td>{{CompatGeckoDesktop(50)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.toStringTag (@@toStringTag)</td> - <td>{{CompatChrome(49)}}</td> - <td>{{CompatGeckoDesktop(51)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatChrome(38)}}</td> - <td>{{CompatGeckoMobile(36)}}</td> - <td>{{CompatNo}}</td> - <td>25</td> - <td>9</td> - </tr> - <tr> - <td>Symbol.iterator (@@iterator)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatChrome(38)}}</td> - <td>{{CompatGeckoMobile(36)}}</td> - <td>{{CompatNo}}</td> - <td>25</td> - <td>9</td> - </tr> - <tr> - <td>Symbol.unscopables (@@unscopables)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatChrome(38)}}</td> - <td>{{CompatGeckoMobile(48)}}</td> - <td>{{CompatNo}}</td> - <td>25</td> - <td>9</td> - </tr> - <tr> - <td>Symbol.match (@@match)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile(40)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.species (@@species)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile(41)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.toPrimitive (@@toPrimitive)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile(44)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.replace (@@replace)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile(48)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.search (@@search)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile(48)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.split (@@split)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile(48)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.isConcatSpreadable (@@isconcatspreadable)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile(48)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.hasInstance (@@hasInstance)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile(50)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td>Symbol.toStringTag (@@toStringTag)</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile(51)}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Glossary/Symbol">Glossary: Symbol data type</a></li> - <li>{{jsxref("Operators/typeof", "typeof")}}</li> - <li><a href="/en-US/docs/Web/JavaScript/Data_structures">Data types and data structures</a></li> - <li><a href="https://hacks.mozilla.org/2015/06/es6-in-depth-symbols/">"ES6 In Depth: Symbols" on hacks.mozilla.org</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/index.html b/files/pt-pt/web/javascript/reference/index.html deleted file mode 100644 index aa2f94e880..0000000000 --- a/files/pt-pt/web/javascript/reference/index.html +++ /dev/null @@ -1,307 +0,0 @@ ---- -title: Referência de JavaScript -slug: Web/JavaScript/Reference -tags: - - ECMAScript6 - - ES6 - - 'I10n:priority' - - JS - - JavaScript - - Programação - - Página Landing - - Referencia - - es -translation_of: Web/JavaScript/Reference ---- -<div>{{JsSidebar}}</div> - -<p>Esta parte da secção de JavaScript na MDN serve como um repositório de factos sobre a linguage JavaScript. Leia mais <a href="/pt-PT/docs/Web/JavaScript/Reference/Sobre">sobre esta referência</a>.</p> - -<h2 id="Integrações">Integrações</h2> - -<p><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects">Objetos integrados padrões de JavaScript</a>, em conjunto com os seus métodos e propriedades.</p> - -<ul class="card-grid"> - <li><span>Propriedades de Valor</span> - - <p>{{JSxRef("Infinity")}}<br> - {{JSxRef("NaN")}}<br> - {{JSxRef("undefined")}}<br> - {{JSxRef("globalThis")}}</p> - </li> - <li><span>Propriedades de Função</span> - <p>{{JSxRef("Global_Objects/eval", "eval()")}}<br> - {{JSxRef("Global_Objects/isFinite", "isFinite()")}}<br> - {{JSxRef("Global_Objects/isNaN", "isNaN()")}}<br> - {{JSxRef("Global_Objects/parseFloat", "parseFloat()")}}<br> - {{JSxRef("Global_Objects/parseInt", "parseInt()")}}<br> - {{JSxRef("Global_Objects/decodeURI", "decodeURI()")}}<br> - {{JSxRef("Global_Objects/decodeURIComponent", "decodeURIComponent()")}}<br> - {{JSxRef("Global_Objects/encodeURI", "encodeURI()")}}<br> - {{JSxRef("Global_Objects/encodeURIComponent", "encodeURIComponent()")}}</p> - </li> - <li><span>Objetos Fundamentais</span> - <p>{{JSxRef("Object")}}<br> - {{JSxRef("Function")}}<br> - {{JSxRef("Boolean")}}<br> - {{JSxRef("Symbol")}}</p> - </li> - <li><span>Objetos de Erro</span> - <p>{{JSxRef("Error")}}<br> - {{JSxRef("AggregateError")}}<br> - {{JSxRef("EvalError")}}<br> - {{JSxRef("InternalError")}}<br> - {{JSxRef("RangeError")}}<br> - {{JSxRef("ReferenceError")}}<br> - {{JSxRef("SyntaxError")}}<br> - {{JSxRef("TypeError")}}<br> - {{JSxRef("URIError")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>Números e Datas</span> - - <p>{{JSxRef("Number")}}<br> - {{JSxRef("BigInt")}}<br> - {{JSxRef("Math")}}<br> - {{JSxRef("Date")}}</p> - </li> - <li><span>Processamento de Texto</span> - <p>{{JSxRef("String")}}<br> - {{JSxRef("RegExp")}}</p> - </li> - <li><span>Coleções Indexadas</span><a href="/en-US/docs/Web/JavaScript/Guide/Numbers_and_dates#Numbers"> </a>{{JSxRef("Array")}}<br> - {{JSxRef("Int8Array")}}<br> - {{JSxRef("Uint8Array")}}<br> - {{JSxRef("Uint8ClampedArray")}}<br> - {{JSxRef("Int16Array")}}<br> - {{JSxRef("Uint16Array")}}<br> - {{JSxRef("Int32Array")}}<br> - {{JSxRef("Uint32Array")}}<br> - {{JSxRef("Float32Array")}}<br> - {{JSxRef("Float64Array")}}<br> - {{JSxRef("BigInt64Array")}}<br> - {{JSxRef("BigUint64Array")}}</li> - <li><span>Coleções ''Keyed''</span> - <p>{{JSxRef("Map")}}<br> - {{JSxRef("Set")}}<br> - {{JSxRef("WeakMap")}}<br> - {{JSxRef("WeakSet")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>Dados Estruturados</span> - - <p>{{JSxRef("ArrayBuffer")}}<br> - {{JSxRef("SharedArrayBuffer")}}<br> - {{JSxRef("Atomics")}}<br> - {{JSxRef("DataView")}}<br> - {{JSxRef("JSON")}}</p> - </li> - <li><span>Abstração de Controlo</span> - <p>{{JSxRef("Promise")}}<br> - {{JSxRef("Generator")}}<br> - {{JSxRef("GeneratorFunction")}}<br> - {{JSxRef("AsyncFunction")}}</p> - </li> - <li><span>Reflexão</span> - <p>{{JSxRef("Reflect")}}<br> - {{JSxRef("Proxy")}}</p> - </li> - <li><span>Internacionalização</span> - <p>{{JSxRef("Intl")}}<br> - {{JSxRef("Global_Objects/Collator", "Intl.Collator")}}<br> - {{JSxRef("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}<br> - {{JSxRef("Global_Objects/ListFormat", "Intl.ListFormat")}}<br> - {{JSxRef("Global_Objects/NumberFormat", "Intl.NumberFormat")}}<br> - {{JSxRef("Global_Objects/PluralRules", "Intl.PluralRules")}}<br> - {{JSxRef("Global_Objects/RelativeTimeFormat", "Intl.RelativeTimeFormat")}}<br> - {{JSxRef("Global_Objects/Locale", "Intl.Locale")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>WebAssembly</span> - - <p>{{JSxRef("WebAssembly")}}<br> - {{JSxRef("WebAssembly.Module")}}<br> - {{JSxRef("WebAssembly.Instance")}}<br> - {{JSxRef("WebAssembly.Memory")}}<br> - {{JSxRef("WebAssembly.Table")}}<br> - {{JSxRef("WebAssembly.CompileError")}}<br> - {{JSxRef("WebAssembly.LinkError")}}<br> - {{JSxRef("WebAssembly.RuntimeError")}}</p> - </li> -</ul> - -<h2 id="Declações_Statements">Declações (Statements)</h2> - -<p><a href="/pt-PT/docs/Web/JavaScript/Reference/Extratos_e_declarações">Declarações e instruções de JavaScript</a></p> - -<ul class="card-grid"> - <li><span>Control flow</span>{{jsxref("Statements/block", "Block")}}<br> - {{jsxref("Statements/break", "break")}}<br> - {{jsxref("Statements/continue", "continue")}}<br> - {{jsxref("Statements/Empty", "Empty")}}<br> - {{jsxref("Statements/if...else", "if...else")}}<br> - {{jsxref("Statements/switch", "switch")}}<br> - {{jsxref("Statements/throw", "throw")}}<br> - {{jsxref("Statements/try...catch", "try...catch")}}</li> - <li><span>Declarations</span> - <p>{{jsxref("Statements/var", "var")}}<br> - {{jsxref("Statements/let", "let")}}<br> - {{jsxref("Statements/const", "const")}}</p> - </li> - <li><span>Functions and classes</span> - <p>{{jsxref("Statements/function", "function")}}<br> - {{jsxref("Statements/function*", "function*")}}<br> - {{jsxref("Statements/async_function", "async function")}}<br> - {{jsxref("Statements/return", "return")}}<br> - {{jsxref("Statements/class", "class")}}</p> - </li> - <li><span>Iterations</span> - <p>{{jsxref("Statements/do...while", "do...while")}}<br> - {{jsxref("Statements/for", "for")}}<br> - {{jsxref("Statements/for_each...in", "for each...in")}}<br> - {{jsxref("Statements/for...in", "for...in")}}<br> - {{jsxref("Statements/for...of", "for...of")}}<br> - {{jsxref("Statements/for-await...of", "for await...of")}}<br> - {{jsxref("Statements/while", "while")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>Outros</span> - - <p>{{jsxref("Statements/debugger", "debugger")}}<br> - {{jsxref("Statements/import", "import")}}<br> - {{jsxref("Statements/label", "label")}}<br> - {{jsxref("Statements/with", "with")}}</p> - </li> -</ul> - -<h2 id="Expressões_e_operadores">Expressões e operadores</h2> - -<p><a href="/pt-PT/docs/Web/JavaScript/Reference/Operadores">Expressões e operadores de JavaScript</a>. </p> - -<div> -<ul class="card-grid"> - <li><span>Primary expressions</span>{{JSxRef("Operators/this", "this")}}<br> - {{JSxRef("Operators/function", "function")}}<br> - {{JSxRef("Operators/class", "class")}}<br> - {{JSxRef("Operators/function*", "function*")}}<br> - {{JSxRef("Operators/yield", "yield")}}<br> - {{JSxRef("Operators/yield*", "yield*")}}<br> - {{JSxRef("Operators/async_function", "async function")}}<br> - {{JSxRef("Operators/await", "await")}}<br> - {{JSxRef("Global_Objects/Array", "[]")}}<br> - {{JSxRef("Operators/Object_initializer", "{}")}}<br> - {{JSxRef("Global_Objects/RegExp", "/ab+c/i")}}<br> - {{JSxRef("Operators/Grouping", "( )")}}<br> - {{JSxRef("null")}}</li> - <li><span>Left-hand-side expressions</span> - <p>{{JSxRef("Operators/Property_accessors", "Property accessors", "", 1)}}<br> - {{JSxRef("Operators/new", "new")}}<br> - {{JSxRef("Operators/new%2Etarget", "new.target")}}<br> - {{JSxRef("Operators/super", "super")}}<br> - {{JSxRef("Operators/Spread_syntax", "...obj")}}</p> - </li> - <li><span>Increment & decrement</span> - <p>{{JSxRef("Operators/Arithmetic_Operators", "A++", "#Increment")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "A--", "#Decrement")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "++A", "#Increment")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "--A", "#Decrement")}}</p> - </li> - <li><span>Unary operators</span> - <p>{{JSxRef("Operators/delete", "delete")}}<br> - {{JSxRef("Operators/void", "void")}}<br> - {{JSxRef("Operators/typeof", "typeof")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "+", "#Unary_plus")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "-", "#Unary_negation")}}<br> - {{JSxRef("Operators/Bitwise_Operators", "~", "#Bitwise_NOT")}}<br> - {{JSxRef("Operators/Logical_Operators", "!", "#Logical_NOT")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>Arithmetic operators</span> - - <p>{{JSxRef("Operators/Arithmetic_Operators", "+", "#Addition")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "-", "#Subtraction")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "/", "#Division")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "*", "#Multiplication")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "%", "#Remainder")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "**", "#Exponentiation")}}</p> - </li> - <li><span>Relational operators</span> - <p>{{JSxRef("Operators/in", "in")}}<br> - {{JSxRef("Operators/instanceof", "instanceof")}}<br> - {{JSxRef("Operators/Comparison_Operators", "<", "#Less_than_operator")}}<br> - {{JSxRef("Operators/Comparison_Operators", ">", "#Greater_than_operator")}}<br> - {{JSxRef("Operators/Comparison_Operators", "<=", "#Less_than_or_equal_operator")}}<br> - {{JSxRef("Operators/Comparison_Operators", ">=", "#Greater_than_or_equal_operator")}}</p> - </li> - <li><span>Equality operators</span> - <p>{{JSxRef("Operators/Comparison_Operators", "==", "#Equality")}}<br> - {{JSxRef("Operators/Comparison_Operators", "!=", "#Inequality")}}<br> - {{JSxRef("Operators/Comparison_Operators", "===", "#Identity")}}<br> - {{JSxRef("Operators/Comparison_Operators", "!==", "#Nonidentity")}}</p> - </li> - <li><span>Bitwise shift operators</span> - <p>{{JSxRef("Operators/Bitwise_Operators", "<<", "#Left_shift")}}<br> - {{JSxRef("Operators/Bitwise_Operators", ">>", "#Right_shift")}}<br> - {{JSxRef("Operators/Bitwise_Operators", ">>>", "#Unsigned_right_shift")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>Binary bitwise operators</span>{{JSxRef("Operators/Bitwise_Operators", "&", "#Bitwise_AND")}}<br> - {{JSxRef("Operators/Bitwise_Operators", "|", "#Bitwise_OR")}}<br> - {{JSxRef("Operators/Bitwise_Operators", "^", "#Bitwise_XOR")}}</li> - <li><span>Binary logical operators</span> - <p>{{JSxRef("Operators/Logical_Operators", "&&", "#Logical_AND")}}<br> - {{JSxRef("Operators/Logical_Operators", "||", "#Logical_OR")}}</p> - </li> - <li><span>Ternary operator</span> - <p>{{JSxRef("Operators/Conditional_Operator", "(condition ? ifTrue : ifFalse)")}}</p> - </li> - <li><span>Assignment operators</span> - <p>{{JSxRef("Operators/Assignment_Operators", "=", "#Assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "*=", "#Multiplication_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "/=", "#Division_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "%=", "#Remainder_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "+=", "#Addition_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "-=", "#Subtraction_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "<<=", "#Left_shift_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", ">>=", "#Right_shift_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", ">>>=", "#Unsigned_right_shift_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "&=", "#Bitwise_AND_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "^=", "#Bitwise_XOR_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "|=", "#Bitwise_OR_assignment")}}<br> - {{JSxRef("Operators/Destructuring_assignment", "[a, b] = [1, 2]")}}<br> - {{JSxRef("Operators/Destructuring_assignment", "{a, b} = {a:1, b:2}")}}</p> - </li> -</ul> -</div> - -<h2 id="Funções">Funções</h2> - -<p>This chapter documents how to work with <a href="/en-US/docs/Web/JavaScript/Reference/Functions">JavaScript functions</a> to develop your applications.</p> - -<ul> - <li><a href="/pt-PT/docs/Web/JavaScript/Reference/Funcoes/arguments"><code>argumentos (arguments)</code></a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions">Arrow functions</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions/Default_parameters">Default parameters</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters">Rest parameters</a></li> -</ul> - -<h2 id="Páginas_adicionais_de_referência">Páginas adicionais de referência</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Lexical_grammar">Lexical grammar</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Data_structures">Data types and data structures</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Strict_mode">Strict mode</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Deprecated_and_obsolete_features">Deprecated features</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/operators/comma_operator/index.html b/files/pt-pt/web/javascript/reference/operators/comma_operator/index.html deleted file mode 100644 index fd3d1ab53c..0000000000 --- a/files/pt-pt/web/javascript/reference/operators/comma_operator/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: Operador Vírgula -slug: Web/JavaScript/Reference/Operators/Comma_Operator -tags: - - Composto - - Expressão - - Funcionalidade de Linguagem - - JavaScript - - Operador - - Referencia - - Vírgula -translation_of: Web/JavaScript/Reference/Operators/Comma_Operator -original_slug: Web/JavaScript/Reference/Operadores/Operador_virgula ---- -<div>Operador {{jsSidebar("Operators")}}</div> - -<p>O <strong>operador vírgula </strong>(<strong><code>,</code></strong>) avalia cada um dos seus operandos (da esquerda para a direita) e devolve o valor do último operando. This lets you create a compound expression in which multiple expressions are evaluated, with the compound expression's final value being the value of the rightmost of its member expressions. This is commonly used to provide multiple parameters to a <code><a href="/en-US/docs/Web/JavaScript/Reference/Statements/for">for</a></code> loop.</p> - -<div>{{EmbedInteractiveExample("pages/js/expressions-commaoperators.html")}}</div> - - - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><em>expr1</em>, <em>expr2, expr3...</em></pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>expr1</code>, <code>expr2</code>, <code>expr3</code>...</dt> - <dd>One or more expressions, the last of which is returned as the value of the compound expression.</dd> -</dl> - -<h2 id="Notas_de_utilização">Notas de utilização</h2> - -<p>You can use the comma operator when you want to include multiple expressions in a location that requires a single expression. The most common usage of this operator is to supply multiple parameters in a <code>for</code> loop.</p> - -<p>The comma operator is fully different from the comma within arrays, objects, and function arguments and parameters.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<p>If <code>a</code> is a 2-dimensional array with 10 elements on each side, the following code uses the comma operator to increment <code>i</code> and decrement <code>j</code> at once.</p> - -<p>The following code prints the values of the diagonal elements in the array:</p> - -<pre class="brush:js;highlight:[1]">for (var i = 0, j = 9; i <= 9; i++, j--) - console.log('a[' + i + '][' + j + '] = ' + a[i][j]);</pre> - -<p>Note that the comma operators in assignments may appear not to have the normal effect of comma operators because they don't exist within an expression. In the following example, <code>a</code> is set to the value of <code>b = 3</code> (which is 3), but the <code>c = 4</code> expression still evaluates and its result returned to console (i.e., 4). This is due to <a href="/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence">operator precedence and associativity</a>.</p> - -<pre class="brush: js">var a, b, c; - -a = b = 3, c = 4; // Returns 4 in console -console.log(a); // 3 (left-most) - -var x, y, z; - -x = (y = 5, z = 6); // Returns 6 in console -console.log(x); // 6 (right-most) -</pre> - -<h3 id="Processing_and_then_returning">Processing and then returning</h3> - -<p>Another example that one could make with comma operator is processing before returning. As stated, only the last element will be returned but all others are going to be evaluated as well. So, one could do:</p> - -<pre class="brush: js">function myFunc() { - var x = 0; - - return (x += 1, x); // the same as return ++x; -}</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-comma-operator', 'Comma operator')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - - - -<p>{{Compat("javascript.operators.comma")}}</p> - -<h2 id="Consulte_também">Consulte também</h2> - -<ul> - <li>Repetição (<em>loop</em>) de <a href="/pt-PT/docs/Web/JavaScript/Reference/Extratos_e_declarações/for"><code>for</code> </a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/operators/function/index.html b/files/pt-pt/web/javascript/reference/operators/function/index.html deleted file mode 100644 index fe2858c796..0000000000 --- a/files/pt-pt/web/javascript/reference/operators/function/index.html +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: Expressão função (Function expression) -slug: Web/JavaScript/Reference/Operators/function -tags: - - Expressões Primárias - - Funiconaldiade de Linguagem - - Função - - JavaScript - - Operador -translation_of: Web/JavaScript/Reference/Operators/function -original_slug: Web/JavaScript/Reference/Operadores/função ---- -<div>{{jsSidebar("Operators")}}</div> - -<p>A palavra-chave <strong><code>function</code></strong> pode ser utilziada para definir uma função dentro de uma expressão.</p> - -<p>You can also define functions using the <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function"><code>Function</code></a> constructor and a <a href="/en-US/docs/Web/JavaScript/Reference/Statements/function"><code>function declaration</code></a>.</p> - -<div>{{EmbedInteractiveExample("pages/js/expressions-functionexpression.html", "shorter")}}</div> - - - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox">let <var>myFunction</var> = function [<var>name</var>]([<var>param1</var>[, <var>param2[</var>, ..., <var>paramN</var>]]]) { - <var>statements</var> -};</pre> - -<p>As of ES2015, you can also use {{jsxref("Functions/Arrow_functions", "arrow functions")}}.</p> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code><var>name</var></code> {{optional_inline}}</dt> - <dd>The function name. Can be omitted, in which case the function is <em>anonymous</em>. The name is only local to the function body.</dd> - <dt><code><var>paramN</var></code> {{optional_inline}}</dt> - <dd>The name of an argument to be passed to the function.</dd> - <dt><code><var>statements</var></code> {{optional_inline}}</dt> - <dd>The statements which comprise the body of the function.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>A function expression is very similar to and has almost the same syntax as a function declaration (see {{jsxref("Statements/function", "function statement")}} for details). The main difference between a function expression and a function declaration is the <em>function name</em>, which can be omitted in function expressions to create <em>anonymous</em> functions. A function expression can be used as an <a href="/en-US/docs/Glossary/IIFE">IIFE (Immediately Invoked Function Expression)</a> which runs as soon as it is defined. See also the chapter about {{jsxref("Functions", "functions")}} for more information.</p> - -<h3 id="Function_expression_hoisting">Function expression hoisting</h3> - -<p>Function expressions in JavaScript are not hoisted, unlike {{jsxref("Statements/function", "function declarations", "#Function_declaration_hoisting")}}. You can't use function expressions before you define them:</p> - -<pre class="brush: js">console.log(notHoisted) // undefined -// even though the variable name is hoisted, the definition isn't. so it's undefined. -notHoisted(); // TypeError: notHoisted is not a function - -var notHoisted = function() { - console.log('bar'); -}; -</pre> - -<h3 id="Named_function_expression">Named function expression</h3> - -<p>If you want to refer to the current function inside the function body, you need to create a named function expression. <u><strong>This name is then local only to the function body (scope)</strong></u>. This also avoids using the non-standard {{jsxref("Functions/arguments/callee", "arguments.callee")}} property.</p> - -<pre class="brush: js">let math = { - 'factit': function factorial(n) { - console.log(n) - if (n <= 1) { - return 1; - } - return n * factorial(n - 1); - } -}; - -math.factit(3) //3;2;1; -</pre> - -<p>The variable the function expression is assigned to will have a <code>name</code> property. The name doesn't change if it's assigned to a different variable. If function name is omitted, it will be the variable name (implicit name). If function name is present, it will be the function name (explicit name). This also applies to {{jsxref("Functions/Arrow_functions", "arrow functions")}} (arrows don't have a name so you can only give the variable an implicit name).</p> - -<pre class="brush: js">var foo = function() {} -foo.name // "foo" - -var foo2 = foo -foo2.name // "foo" - -var bar = function baz() {} -bar.name // "baz" - -console.log(foo === foo2); // true -console.log(typeof baz); // undefined -console.log(bar === baz); // false (errors because baz == undefined) -</pre> - -<h2 id="Exemplos">Exemplos</h2> - -<p>The following example defines an unnamed function and assigns it to <code>x</code>. The function returns the square of its argument:</p> - -<pre class="brush: js">var x = function(y) { - return y * y; -}; -</pre> - -<p>More commonly it is used as a <a href="/en-US/docs/Glossary/Callback_function">callback</a>:</p> - -<pre class="brush: js">button.addEventListener('click', function(event) { - console.log('button is clicked!') -})</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-function-definitions', 'Function definitions')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - - - -<p>{{Compat("javascript.operators.function")}}</p> - -<h2 id="Consulte_também">Consulte também </h2> - -<ul> - <li>{{jsxref("Arrow_functions", "Arrow functions")}}</li> - <li>{{jsxref("Functions_and_function_scope", "Functions and function scope")}}</li> - <li>{{jsxref("Function")}}</li> - <li>{{jsxref("Statements/function", "function statement")}}</li> - <li>{{jsxref("Statements/function*", "function* statement")}}</li> - <li>{{jsxref("Operators/function*", "function* expression")}}</li> - <li>{{jsxref("GeneratorFunction")}}</li> - <li>{{jsxref("Statements/async_function", "async function")}}</li> - <li>{{jsxref("Operators/async_function", "async function expression")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/operators/index.html b/files/pt-pt/web/javascript/reference/operators/index.html deleted file mode 100644 index 2856a917bc..0000000000 --- a/files/pt-pt/web/javascript/reference/operators/index.html +++ /dev/null @@ -1,310 +0,0 @@ ---- -title: Expressões e operadores -slug: Web/JavaScript/Reference/Operators -tags: - - JavaScript - - Operadores - - Página Landing - - Resumo - - Sinopse -translation_of: Web/JavaScript/Reference/Operators -original_slug: Web/JavaScript/Reference/Operadores ---- -<div>{{jsSidebar("Operators")}}</div> - -<p>Este capítulo documenta todos os operadores, expressões e palavras-chave da linguagem JavaScript.</p> - -<h2 id="Expressões_e_operadores_por_categoria">Expressões e operadores por categoria</h2> - -<p>For an alphabetical listing see the sidebar on the left.</p> - -<h3 id="Expressões_primárias">Expressões primárias</h3> - -<p>Basic keywords and general expressions in JavaScript.</p> - -<dl> - <dt>{{JSxRef("Operators/this", "this")}}</dt> - <dd>The <code>this</code> keyword refers to a special property of an execution context.</dd> - <dt>{{JSxRef("Operators/function", "function")}}</dt> - <dd>The <code>function</code> keyword defines a function expression.</dd> - <dt>{{JSxRef("Operators/class", "class")}}</dt> - <dd>The <code>class</code> keyword defines a class expression.</dd> - <dt>{{JSxRef("Operators/function*", "function*")}}</dt> - <dd>The <code>function*</code> keyword defines a generator function expression.</dd> - <dt>{{JSxRef("Operators/yield", "yield")}}</dt> - <dd>Pause and resume a generator function.</dd> - <dt>{{JSxRef("Operators/yield*", "yield*")}}</dt> - <dd>Delegate to another generator function or iterable object.</dd> - <dt>{{JSxRef("Operators/async_function", "async function")}}</dt> - <dd>The <code>async function</code> defines an async function expression.</dd> - <dt>{{JSxRef("Operators/await", "await")}}</dt> - <dd>Pause and resume an async function and wait for the promise's resolution/rejection.</dd> - <dt>{{JSxRef("Global_Objects/Array", "[]")}}</dt> - <dd>Array initializer/literal syntax.</dd> - <dt>{{JSxRef("Operators/Object_initializer", "{}")}}</dt> - <dd>Object initializer/literal syntax.</dd> - <dt>{{JSxRef("Global_Objects/RegExp", "/ab+c/i")}}</dt> - <dd>Regular expression literal syntax.</dd> - <dt>{{JSxRef("Operators/Grouping", "( )")}}</dt> - <dd>Grouping operator.</dd> -</dl> - -<h3 id="Expressões_Left-hand-side">Expressões "Left-hand-side"</h3> - -<p>Left values are the destination of an assignment.</p> - -<dl> - <dt>{{jsxref("Operators/Property_accessors", "Property accessors", "", 1)}}</dt> - <dd>Member operators provide access to a property or method of an object<br> - (<code>object.property</code> and <code>object["property"]</code>).</dd> - <dt>{{jsxref("Operators/new", "new")}}</dt> - <dd>The <code>new</code> operator creates an instance of a constructor.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Operators/new.target">new.target</a></dt> - <dd>In constructors, <code>new.target</code> refers to the constructor that was invoked by {{jsxref("Operators/new", "new")}}.</dd> - <dt>{{jsxref("Operators/super", "super")}}</dt> - <dd>The <code>super</code> keyword calls the parent constructor.</dd> - <dt>{{jsxref("Operators/Spread_operator", "...obj")}}</dt> - <dd>The spread operator allows an expression to be expanded in places where multiple arguments (for function calls) or multiple elements (for array literals) are expected.</dd> -</dl> - -<h3 id="Aumento_e_diminuição">Aumento e diminuição</h3> - -<p>Postfix/prefix increment and postfix/prefix decrement operators.</p> - -<dl> - <dt>{{jsxref("Operators/Arithmetic_Operators", "A++", "#Increment")}}</dt> - <dd>Postfix increment operator.</dd> - <dt>{{jsxref("Operators/Arithmetic_Operators", "A--", "#Decrement")}}</dt> - <dd>Postfix decrement operator.</dd> - <dt>{{jsxref("Operators/Arithmetic_Operators", "++A", "#Increment")}}</dt> - <dd>Prefix increment operator.</dd> - <dt>{{jsxref("Operators/Arithmetic_Operators", "--A", "#Decrement")}}</dt> - <dd>Prefix decrement operator.</dd> -</dl> - -<h3 id="Operadores_unários">Operadores unários</h3> - -<p>A unary operation is operation with only one operand.</p> - -<dl> - <dt>{{jsxref("Operators/delete", "delete")}}</dt> - <dd>The <code>delete</code> operator deletes a property from an object.</dd> - <dt>{{jsxref("Operators/void", "void")}}</dt> - <dd>The <code>void</code> operator discards an expression's return value.</dd> - <dt>{{jsxref("Operators/typeof", "typeof")}}</dt> - <dd>The <code>typeof</code> operator determines the type of a given object.</dd> - <dt>{{jsxref("Operators/Arithmetic_Operators", "+", "#Unary_plus")}}</dt> - <dd>The unary plus operator converts its operand to Number type.</dd> - <dt>{{jsxref("Operators/Arithmetic_Operators", "-", "#Unary_negation")}}</dt> - <dd>The unary negation operator converts its operand to Number type and then negates it.</dd> - <dt>{{jsxref("Operators/Bitwise_Operators", "~", "#Bitwise_NOT")}}</dt> - <dd>Bitwise NOT operator.</dd> - <dt>{{jsxref("Operators/Logical_Operators", "!", "#Logical_NOT")}}</dt> - <dd>Logical NOT operator.</dd> -</dl> - -<h3 id="Operadores_de_aritmética">Operadores de aritmética</h3> - -<p>Arithmetic operators take numerical values (either literals or variables) as their operands and return a single numerical value.</p> - -<dl> - <dt>{{jsxref("Operators/Arithmetic_Operators", "+", "#Addition")}}</dt> - <dd>Addition operator.</dd> - <dt>{{jsxref("Operators/Arithmetic_Operators", "-", "#Subtraction")}}</dt> - <dd>Subtraction operator.</dd> - <dt>{{jsxref("Operators/Arithmetic_Operators", "/", "#Division")}}</dt> - <dd>Division operator.</dd> - <dt>{{jsxref("Operators/Arithmetic_Operators", "*", "#Multiplication")}}</dt> - <dd>Multiplication operator.</dd> - <dt>{{jsxref("Operators/Arithmetic_Operators", "%", "#Remainder")}}</dt> - <dd>Remainder operator.</dd> -</dl> - -<dl> - <dt>{{JSxRef("Operators/Arithmetic_Operators", "**", "#Exponentiation")}}</dt> - <dd>Exponentiation operator.</dd> -</dl> - -<h3 id="Operadores_relacionais">Operadores relacionais</h3> - -<p>A comparison operator compares its operands and returns a <code>Boolean</code> value based on whether the comparison is true.</p> - -<dl> - <dt>{{jsxref("Operators/in", "in")}}</dt> - <dd>The <code>in</code> operator determines whether an object has a given property.</dd> - <dt>{{jsxref("Operators/instanceof", "instanceof")}}</dt> - <dd>The <code>instanceof</code> operator determines whether an object is an instance of another object.</dd> - <dt>{{jsxref("Operators/Comparison_Operators", "<", "#Less_than_operator")}}</dt> - <dd>Less than operator.</dd> - <dt>{{jsxref("Operators/Comparison_Operators", ">", "#Greater_than_operator")}}</dt> - <dd>Greater than operator.</dd> - <dt>{{jsxref("Operators/Comparison_Operators", "<=", "#Less_than_or_equal_operator")}}</dt> - <dd>Less than or equal operator.</dd> - <dt>{{jsxref("Operators/Comparison_Operators", ">=", "#Greater_than_or_equal_operator")}}</dt> - <dd>Greater than or equal operator.</dd> -</dl> - -<div class="note"> -<p><strong>Nota: =></strong> não é um operador, mas a notação para <a href="/pt-PT/docs/Web/JavaScript/Reference/Funcoes/Funcoes_seta">funções seta (<em>arrow</em></a>).</p> -</div> - -<h3 id="Operadores_de_equality">Operadores de <em>equality</em></h3> - -<p>The result of evaluating an equality operator is always of type <code>Boolean</code> based on whether the comparison is true.</p> - -<dl> - <dt>{{jsxref("Operators/Comparison_Operators", "==", "#Equality")}}</dt> - <dd>Equality operator.</dd> - <dt>{{jsxref("Operators/Comparison_Operators", "!=", "#Inequality")}}</dt> - <dd>Inequality operator.</dd> - <dt>{{jsxref("Operators/Comparison_Operators", "===", "#Identity")}}</dt> - <dd>Identity operator.</dd> - <dt>{{jsxref("Operators/Comparison_Operators", "!==", "#Nonidentity")}}</dt> - <dd>Nonidentity operator.</dd> -</dl> - -<h3 id="Bitwise_shift_operators">Bitwise shift operators</h3> - -<p>Operations to shift all bits of the operand.</p> - -<dl> - <dt>{{jsxref("Operators/Bitwise_Operators", "<<", "#Left_shift")}}</dt> - <dd>Bitwise left shift operator.</dd> - <dt>{{jsxref("Operators/Bitwise_Operators", ">>", "#Right_shift")}}</dt> - <dd>Bitwise right shift operator.</dd> - <dt>{{jsxref("Operators/Bitwise_Operators", ">>>", "#Unsigned_right_shift")}}</dt> - <dd>Bitwise unsigned right shift operator.</dd> -</dl> - -<h3 id="Operadores_de_binário_bitwise">Operadores de binário <em>bitwise</em></h3> - -<p>Bitwise operators treat their operands as a set of 32 bits (zeros and ones) and return standard JavaScript numerical values.</p> - -<dl> - <dt>{{jsxref("Operators/Bitwise_Operators", "&", "#Bitwise_AND")}}</dt> - <dd>Bitwise AND.</dd> - <dt>{{jsxref("Operators/Bitwise_Operators", "|", "#Bitwise_OR")}}</dt> - <dd>Bitwise OR.</dd> - <dt>{{jsxref("Operators/Bitwise_Operators", "^", "#Bitwise_XOR")}}</dt> - <dd>Bitwise XOR.</dd> -</dl> - -<h3 id="Operadores_de_binário_logical">Operadores de binário <em>logical</em></h3> - -<p>Logical operators are typically used with boolean (logical) values, and when they are, they return a boolean value.</p> - -<dl> - <dt>{{jsxref("Operators/Logical_Operators", "&&", "#Logical_AND")}}</dt> - <dd>Logical AND.</dd> - <dt>{{jsxref("Operators/Logical_Operators", "||", "#Logical_OR")}}</dt> - <dd>Logical OR.</dd> -</dl> - -<h3 id="Operdor_condicional_ternário">Operdor condicional (ternário)</h3> - -<dl> - <dt>{{jsxref("Operators/Conditional_Operator", "(condition ? ifTrue : ifFalse)")}}</dt> - <dd> - <p>The conditional operator returns one of two values based on the logical value of the condition.</p> - </dd> -</dl> - -<h3 id="Operadores_de_Assignment">Operadores de <em>Assignment</em></h3> - -<p>An assignment operator assigns a value to its left operand based on the value of its right operand.</p> - -<dl> - <dt>{{jsxref("Operators/Assignment_Operators", "=", "#Assignment")}}</dt> - <dd>Assignment operator.</dd> - <dt>{{jsxref("Operators/Assignment_Operators", "*=", "#Multiplication_assignment")}}</dt> - <dd>Multiplication assignment.</dd> - <dt>{{jsxref("Operators/Assignment_Operators", "/=", "#Division_assignment")}}</dt> - <dd>Division assignment.</dd> - <dt>{{jsxref("Operators/Assignment_Operators", "%=", "#Remainder_assignment")}}</dt> - <dd>Remainder assignment.</dd> - <dt>{{jsxref("Operators/Assignment_Operators", "+=", "#Addition_assignment")}}</dt> - <dd>Addition assignment.</dd> - <dt>{{jsxref("Operators/Assignment_Operators", "-=", "#Subtraction_assignment")}}</dt> - <dd>Subtraction assignment</dd> - <dt>{{jsxref("Operators/Assignment_Operators", "<<=", "#Left_shift_assignment")}}</dt> - <dd>Left shift assignment.</dd> - <dt>{{jsxref("Operators/Assignment_Operators", ">>=", "#Right_shift_assignment")}}</dt> - <dd>Right shift assignment.</dd> - <dt>{{jsxref("Operators/Assignment_Operators", ">>>=", "#Unsigned_right_shift_assignment")}}</dt> - <dd>Unsigned right shift assignment.</dd> - <dt>{{jsxref("Operators/Assignment_Operators", "&=", "#Bitwise_AND_assignment")}}</dt> - <dd>Bitwise AND assignment.</dd> - <dt>{{jsxref("Operators/Assignment_Operators", "^=", "#Bitwise_XOR_assignment")}}</dt> - <dd>Bitwise XOR assignment.</dd> - <dt>{{jsxref("Operators/Assignment_Operators", "|=", "#Bitwise_OR_assignment")}}</dt> - <dd>Bitwise OR assignment.</dd> - <dt>{{jsxref("Operators/Destructuring_assignment", "[a, b] = [1, 2]")}}<br> - {{jsxref("Operators/Destructuring_assignment", "{a, b} = {a:1, b:2}")}}</dt> - <dd> - <p>Destructuring assignment allows you to assign the properties of an array or object to variables using syntax that looks similar to array or object literals.</p> - </dd> -</dl> - -<h3 id="Operador_de_aspas">Operador de aspas</h3> - -<dl> - <dt>{{jsxref("Operators/Comma_Operator", ",")}}</dt> - <dd>The comma operator allows multiple expressions to be evaluated in a single statement and returns the result of the last expression.</dd> -</dl> - -<h3 id="Funcionalidades_não_padrão">Funcionalidades não padrão</h3> - -<dl> - <dt>{{non-standard_inline}} {{jsxref("Operators/Legacy_generator_function", "Legacy generator function", "", 1)}}</dt> - <dd>The <code>function</code> keyword can be used to define a legacy generator function inside an expression. To make the function a legacy generator, the function body should contains at least one {{jsxref("Operators/yield", "yield")}} expression.</dd> - <dt>{{non-standard_inline}} {{jsxref("Operators/Expression_closures", "Expression closures", "", 1)}}</dt> - <dd>The expression closure syntax is a shorthand for writing simple function.</dd> - <dt>{{non-standard_inline}} {{jsxref("Operators/Array_comprehensions", "[for (x of y) x]")}}</dt> - <dd>Array comprehensions.</dd> - <dt>{{non-standard_inline}} {{jsxref("Operators/Generator_comprehensions", "(for (x of y) y)")}}</dt> - <dd>Generator comprehensions.</dd> -</dl> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1', '#sec-11', 'Expressions')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-11', 'Expressions')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-ecmascript-language-expressions', 'ECMAScript Language: Expressions')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>New: Spread operator, destructuring assignment, <code>super</code> keyword.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-ecmascript-language-expressions', 'ECMAScript Language: Expressions')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - - - -<p>{{Compat("javascript.operators")}}</p> - -<h2 id="Consulte_também">Consulte também</h2> - -<ul> - <li><a href="/pt-PT/docs/Web/JavaScript/Reference/Operadores/Precedencia_operador">Precedência de operador</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/operators/operator_precedence/index.html b/files/pt-pt/web/javascript/reference/operators/operator_precedence/index.html deleted file mode 100644 index a33ba19b4b..0000000000 --- a/files/pt-pt/web/javascript/reference/operators/operator_precedence/index.html +++ /dev/null @@ -1,462 +0,0 @@ ---- -title: Precedência de operador -slug: Web/JavaScript/Reference/Operators/Operator_Precedence -tags: - - Guía - - JavaScript - - precedência -translation_of: Web/JavaScript/Reference/Operators/Operator_Precedence -original_slug: Web/JavaScript/Reference/Operadores/Precedencia_operador ---- -<div>{{jsSidebar("Operators")}}</div> - -<p>A <strong>precedência de operador</strong> determina a maneira pela qual os operadores são analisados em relação a cada um. Os operadores com maior precedência tornam-se operandos dos operadores com menor precedência..</p> - -<div>{{EmbedInteractiveExample("pages/js/expressions-operatorprecedence.html")}}</div> - - - -<h2 id="Precedência_e_Associabilidade">Precedência e Associabilidade</h2> - -<p>Consider an expression describable by the representation below. Note that both OP<sub>1</sub> and OP<sub>2 </sub>are fill-in-the-blanks for OPerators.</p> - -<pre class="syntaxbox">a OP b OP c -</pre> - -<p>If <code>OP<sub>1</sub></code> and <code>OP<sub>2</sub></code> have different precedence levels (see the table below), the operator with the highest precedence goes first and associativity does not matter. Observe how multiplication has higher associativity than addition and executed first, even though addition is written first in the code.</p> - -<pre>console.log(3 + 10 * 2); // logs 23 -console.log(3 + (10 * 2)); // logs 23 because parentheses here are superfluous -console.log((3 + 10) * 2); // logs 26 because the parentheses change the order </pre> - -<p>Left-associativity (left-to-right) means that it is processed as <code>(a OP<sub>1</sub> b) OP<sub>2</sub> c</code>, while right-associativity (right-to-left) means it is interpreted as <code>a OP<sub>1</sub> (b OP<sub>2</sub> c)</code>. Assignment operators are right-associative, so you can write:</p> - -<pre>a = b = 5; // same as writing a = (b = 5); -</pre> - -<p>with the expected result that <code>a</code> and <code>b</code> get the value 5. This is because the assignment operator returns the value that is assigned. First, <code>b</code> is set to 5. Then the <code>a</code> is also set to 5, the return value of <code>b = 5</code>, aka right operand of the assignment.</p> - -<p>As another example, the unique exponentiation operator has right-associativity, whereas other arithmetic operators have left-associativity. It is interesting to note that, the order of evaluation is always left-to-right irregardless of associativity.</p> - -<table> - <tbody> - <tr> - <td>Código</td> - <td>Resultado</td> - </tr> - <tr> - <td> - <pre> -function echo(name, num) { - console.log("Evaluating the " + name + " side"); - return num; -} -// Notice the division operator (/) -console.log(echo("left", 6) / echo("right", 2)); -</pre> - </td> - <td> - <pre> -Evaluating the left side -Evaluating the right side -3 -</pre> - </td> - </tr> - <tr> - <td> - <pre> -function echo(name, num) { - console.log("Evaluating the " + name + " side"); - return num; -} -// Notice the exponentiation operator (**) -console.log(echo("left", 2) ** echo("right", 3));</pre> - </td> - <td> - <pre> -Evaluating the left side -Evaluating the right side -8</pre> - </td> - </tr> - </tbody> -</table> - -<p>The difference in associativity comes into play when there are multiple operators of the same precedence. With only one operator or operators of different precedences, associativity does affect the output, as seen in the example above. In the example below, observe how associativity affects the output when multiple of the same operator are used.</p> - -<table> - <tbody> - <tr> - <td>Código</td> - <td>Resultado</td> - </tr> - <tr> - <td> - <pre> -function echo(name, num) { - console.log("Evaluating the " + name + " side"); - return num; -} -// Notice the division operator (/) -console.log(echo("left", 6) / echo("middle", 2) / echo("right", 3)); -</pre> - </td> - <td> - <pre> -Evaluating the left side -Evaluating the middle side -Evaluating the right side -1 -</pre> - </td> - </tr> - <tr> - <td> - <pre> -function echo(name, num) { - console.log("Evaluating the " + name + " side"); - return num; -} -// Notice the exponentiation operator (**) -console.log(echo("left", 2) ** echo("middle", 3) ** echo("right", 2)); -</pre> - </td> - <td> - <pre> -Evaluating the left side -Evaluating the middle side -Evaluating the right side -512 -</pre> - </td> - </tr> - <tr> - <td> - <pre> -function echo(name, num) { - console.log("Evaluating the " + name + " side"); - return num; -} -// Notice the parentheses around the left and middle exponentiation -console.log((echo("left", 2) ** echo("middle", 3)) ** echo("right", 2));</pre> - </td> - <td> - <pre> -Evaluating the left side -Evaluating the middle side -Evaluating the right side -64</pre> - </td> - </tr> - </tbody> -</table> - -<p>Looking at the code snippets above, <code>6 / 3 / 2</code> is the same as <code>(6 / 3) / 2</code> because division is left-associative. Exponentiation, on the other hand, is right-associative, so <code>2 ** 3 ** 2</code> is the same as <code>2 ** (3 ** 2)</code>. Thus, doing (<code>2 ** 3) ** 2</code> changes the order and results in the 64 seen in the table above.</p> - -<p>Remember that precedence comes before associativity. So, mixing division and exponentiation, the exponentiation comes before the division. For example, <code>2 ** 3 / 3 ** 2</code> results in 0.8888888888888888 because it is the same as <code>(2 ** 3) / (3 ** 2)</code>.</p> - -<h3 id="Note_on_Grouping_and_Short-Circuiting">Note on Grouping and Short-Circuiting</h3> - -<p>In the table below, <strong>Grouping</strong> is listed as having the highest precedence. However, that does not always mean the expression within the grouping symbols <code>( … )</code> is evaluated first, especially when it comes to short-circuiting.</p> - -<p>Short-circuiting is jargon for conditional evaluation. For example, in the expression <code>a && (b + c)</code>, if <code>a</code> is <a href="https://wiki.developer.mozilla.org/en-US/docs/Glossary/Falsy">“falsy”</a>, then the sub-expression <code>(b + c)</code> will not even get evaluated, even if it is in parentheses. We could say that the logical disjunction operator (“OR”) is “short-circuited”. Along with logical disjunction, other short-circuited operators include logical conjunction (“AND”), nullish-coalescing, optional chaining, and the conditional operator. Some more examples follow.</p> - -<pre>a || (b * c); // evaluate `a` first, then produce `a` if `a` is “truthy” -a && (b < c); // evaluate `a` first, then produce `a` if `a` is “falsy” -a ?? (b || c); // evaluate `a` first, then produce `a` if `a` is not `null` and not `undefined` -a?.b.c; // evaluate `a` first, then produce `a` if `a` is `null` or `undefined` -</pre> - -<h2 id="Exemplos">Exemplos</h2> - -<pre>3 > 2 && 2 > 1 -// returns true - -3 > 2 > 1 -// Returns false because 3 > 2 is true, then true is converted to 1 in inequality operators, therefore true > 1 becomes 1 > 1, which -// is false. Adding parentheses makes things clear: (3 > 2) > 1. - -</pre> - -<h2 id="Tabela">Tabela</h2> - -<p>The following table is ordered from highest (20) to lowest (1) precedence.</p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <th>Precedência</th> - <th>Tipo de operador (Operator)</th> - <th>Associatividade</th> - <th>Operadores individuais</th> - </tr> - <tr> - <td>20</td> - <td>{{jsxref("Operators/Grouping", "Grouping")}}</td> - <td>n/a</td> - <td><code>( … )</code></td> - </tr> - <tr> - <td colspan="1" rowspan="4">19</td> - <td>{{jsxref("Operators/Property_Accessors", "Member Access", "#Dot_notation")}}</td> - <td>left-to-right</td> - <td><code>… . …</code></td> - </tr> - <tr> - <td>{{jsxref("Operators/Property_Accessors", "Computed Member Access","#Bracket_notation")}}</td> - <td>left-to-right</td> - <td><code>… [ … ]</code></td> - </tr> - <tr> - <td>{{jsxref("Operators/new","new")}} (with argument list)</td> - <td>n/a</td> - <td><code>new … ( … )</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Guide/Functions">Function Call</a></td> - <td>left-to-right</td> - <td><code>… ( <var>… </var>)</code></td> - </tr> - <tr> - <td rowspan="1">18</td> - <td>{{jsxref("Operators/new","new")}} (without argument list)</td> - <td>right-to-left</td> - <td><code>new …</code></td> - </tr> - <tr> - <td rowspan="2">17</td> - <td>{{jsxref("Operators/Arithmetic_Operators","Postfix Increment","#Increment")}}</td> - <td colspan="1" rowspan="2">n/a</td> - <td><code>… ++</code></td> - </tr> - <tr> - <td>{{jsxref("Operators/Arithmetic_Operators","Postfix Decrement","#Decrement")}}</td> - <td><code>… --</code></td> - </tr> - <tr> - <td colspan="1" rowspan="10">16</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Logical_Operators#Logical_NOT">Logical NOT</a></td> - <td colspan="1" rowspan="10">right-to-left</td> - <td><code>! …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators#Bitwise_NOT">Bitwise NOT</a></td> - <td><code>~ …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators#Unary_plus">Unary Plus</a></td> - <td><code>+ …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators#Unary_negation">Unary Negation</a></td> - <td><code>- …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators#Increment">Prefix Increment</a></td> - <td><code>++ …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators#Decrement">Prefix Decrement</a></td> - <td><code>-- …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/typeof">typeof</a></td> - <td><code>typeof …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/void">void</a></td> - <td><code>void …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/delete">delete</a></td> - <td><code>delete …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/await">await</a></td> - <td><code>await …</code></td> - </tr> - <tr> - <td>15</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators#Exponentiation">Exponentiation</a></td> - <td>right-to-left</td> - <td><code>… ** …</code></td> - </tr> - <tr> - <td rowspan="3">14</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators#Multiplication">Multiplication</a></td> - <td colspan="1" rowspan="3">left-to-right</td> - <td><code>… * …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators#Division">Division</a></td> - <td><code>… / …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators#Remainder">Remainder</a></td> - <td><code>… % …</code></td> - </tr> - <tr> - <td rowspan="2">13</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators#Addition">Addition</a></td> - <td colspan="1" rowspan="2">left-to-right</td> - <td><code>… + …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators#Subtraction">Subtraction</a></td> - <td><code>… - …</code></td> - </tr> - <tr> - <td rowspan="3">12</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators">Bitwise Left Shift</a></td> - <td colspan="1" rowspan="3">left-to-right</td> - <td><code>… << …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators">Bitwise Right Shift</a></td> - <td><code>… >> …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators">Bitwise Unsigned Right Shift</a></td> - <td><code>… >>> …</code></td> - </tr> - <tr> - <td rowspan="6">11</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Comparison_Operators#Less_than_operator">Less Than</a></td> - <td colspan="1" rowspan="6">left-to-right</td> - <td><code>… < …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Comparison_Operators#Less_than__or_equal_operator">Less Than Or Equal</a></td> - <td><code>… <= …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Comparison_Operators#Greater_than_operator">Greater Than</a></td> - <td><code>… > …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Comparison_Operators#Greater_than_or_equal_operator">Greater Than Or Equal</a></td> - <td><code>… >= …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/in">in</a></td> - <td><code>… in …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/instanceof">instanceof</a></td> - <td><code>… instanceof …</code></td> - </tr> - <tr> - <td rowspan="4">10</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Comparison_Operators#Equality">Equality</a></td> - <td colspan="1" rowspan="4">left-to-right</td> - <td><code>… == …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Comparison_Operators#Inequality">Inequality</a></td> - <td><code>… != …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Comparison_Operators#Identity">Strict Equality</a></td> - <td><code>… === …</code></td> - </tr> - <tr> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Comparison_Operators#Nonidentity">Strict Inequality</a></td> - <td><code>… !== …</code></td> - </tr> - <tr> - <td>9</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators#Bitwise_AND">Bitwise AND</a></td> - <td>left-to-right</td> - <td><code>… & …</code></td> - </tr> - <tr> - <td>8</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators#Bitwise_XOR">Bitwise XOR</a></td> - <td>left-to-right</td> - <td><code>… ^ …</code></td> - </tr> - <tr> - <td>7</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators#Bitwise_OR">Bitwise OR</a></td> - <td>left-to-right</td> - <td><code>… | …</code></td> - </tr> - <tr> - <td>6</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Logical_Operators#Logical_AND">Logical AND</a></td> - <td>left-to-right</td> - <td><code>… && …</code></td> - </tr> - <tr> - <td>5</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Logical_Operators#Logical_OR">Logical OR</a></td> - <td>left-to-right</td> - <td><code>… || …</code></td> - </tr> - <tr> - <td>4</td> - <td><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Conditional_Operator">Conditional</a></td> - <td>right-to-left</td> - <td><code>… ? … : …</code></td> - </tr> - <tr> - <td rowspan="13">3</td> - <td rowspan="13"><a href="/en-US/docs/Web/JavaScript/Reference/Operators/Assignment_Operators">Assignment</a></td> - <td rowspan="13">right-to-left</td> - <td><code>… = …</code></td> - </tr> - <tr> - <td><code>… += …</code></td> - </tr> - <tr> - <td><code>… -= …</code></td> - </tr> - <tr> - <td><code>… **= …</code></td> - </tr> - <tr> - <td><code>… *= …</code></td> - </tr> - <tr> - <td><code>… /= …</code></td> - </tr> - <tr> - <td><code>… %= …</code></td> - </tr> - <tr> - <td><code>… <<= …</code></td> - </tr> - <tr> - <td><code>… >>= …</code></td> - </tr> - <tr> - <td><code>… >>>= …</code></td> - </tr> - <tr> - <td><code>… &= …</code></td> - </tr> - <tr> - <td><code>… ^= …</code></td> - </tr> - <tr> - <td><code>… |= …</code></td> - </tr> - <tr> - <td rowspan="2">2</td> - <td>{{jsxref("Operators/yield", "yield")}}</td> - <td colspan="1" rowspan="2">right-to-left</td> - <td><code>yield …</code></td> - </tr> - <tr> - <td>{{jsxref("Operators/yield*", "yield*")}}</td> - <td><code>yield* …</code></td> - </tr> - <tr> - <td>1</td> - <td><a href="/pt-PT/docs/Web/JavaScript/Reference/Operadores/Operador_virgula">Vírgula / Sequência</a></td> - <td>left-to-right</td> - <td><code>… , …</code></td> - </tr> - </tbody> -</table> diff --git a/files/pt-pt/web/javascript/reference/statements/block/index.html b/files/pt-pt/web/javascript/reference/statements/block/index.html deleted file mode 100644 index 4a6507702f..0000000000 --- a/files/pt-pt/web/javascript/reference/statements/block/index.html +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: Bloco (block) -slug: Web/JavaScript/Reference/Statements/block -tags: - - Declaração - - Funcionalidade de Linguagem - - JavaScript - - Referencia -translation_of: Web/JavaScript/Reference/Statements/block -original_slug: Web/JavaScript/Reference/Extratos_e_declarações/bloco ---- -<div>Bloco {{jsSidebar("Statements")}}</div> - -<p>Uma <strong>declaralção bloco </strong>(ou <strong>declaração composto</strong> em outras linguagens) é utilizada para agrupar zero ou mais declarações. O bloco é delimitado por um par de chavetas (“chavetas { }”) e opcionalmente poderá ser {{jsxref("Statements/label", "labelled", "", 1)}}:</p> - -<div>{{EmbedInteractiveExample("pages/js/statement-block.html", "taller")}}</div> - - - -<h2 id="Sintaxe">Sintaxe</h2> - -<h3 id="Declaração_de_Bloco">Declaração de Bloco</h3> - -<pre class="syntaxbox">{ - <em>StatementList</em> -} -</pre> - -<h3 id="Declaração_de_Bloco_Etiquetado">Declaração de Bloco Etiquetado</h3> - -<pre class="syntaxbox"><em>LabelIdentifier</em>: { - <em>StatementList</em> -} -</pre> - -<dl> - <dt><code>StatementList</code></dt> - <dd>Statements grouped within the block statement.</dd> - <dt><code>LabelIdentifier</code></dt> - <dd>An optional {{jsxref("Statements/label", "label", "", 1)}} for visual identification or as a target for {{jsxref("Statements/break", "break")}}.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>The block statement is often called <strong>compound statement</strong> in other languages. It allows you to use multiple statements where JavaScript expects only one statement. Combining statements into blocks is a common practice in JavaScript. The opposite behavior is possible using an <a href="/en-US/docs/Web/JavaScript/Reference/Statements/Empty">empty statement</a>, where you provide no statement, although one is required.</p> - -<p>Blocks are commonly used in association with {{jsxref("Statements/if...else", "if...else")}} and {{jsxref("Statements/for", "for")}} statements.</p> - -<h3 id="Block_Scoping_Rules">Block Scoping Rules</h3> - -<h4 id="With_var_or_function_declaration_in_non-strict_mode">With <code>var</code> or function declaration in non-strict mode</h4> - -<p>Variables declared with <code>var</code> or created by <a href="/en-US/docs/Web/JavaScript/Reference/Statements/function">function declarations</a> in non-strict mode <strong>do not</strong> have block scope. Variables introduced within a block are scoped to the containing function or script, and the effects of setting them persist beyond the block itself. In other words, block statements do not introduce a scope. For example:</p> - -<pre class="brush: js example-bad">var x = 1; -{ - var x = 2; -} -console.log(x); // logs 2 -</pre> - -<p>This logs 2 because the <code>var x</code> statement within the block is in the same scope as the <code>var x</code> statement before the block.</p> - -<p>In non-strict code, function declarations inside blocks behave strangely. Do not use them.</p> - -<h4 id="With_let_const_or_function_declaration_in_strict_mode">With <code>let</code>, <code>const</code> or function declaration in strict mode</h4> - -<p>By contrast, identifiers declared with {{jsxref("Statements/let", "let")}} and {{jsxref("Statements/const", "const")}} <strong>do have </strong>block scope:</p> - -<pre class="brush: js">let x = 1; -{ - let x = 2; -} -console.log(x); // logs 1</pre> - -<p>The <code>x = 2</code> is limited in scope to the block in which it was defined.</p> - -<p>The same is true of <code>const</code>:</p> - -<pre class="brush: js">const c = 1; -{ - const c = 2; -} -console.log(c); // logs 1 and does not throw SyntaxError...</pre> - -<p>Note that the block-scoped <code>const c = 2</code> <em>does not</em> throw a <code>SyntaxError: Identifier 'c' has already been declared</code> because it can be declared uniquely within the block.</p> - -<p>In <a href="/en-US/docs/Web/JavaScript/Reference/Strict_mode">strict mode</a>, starting with ES2015, functions inside blocks are scoped to that block. Prior to ES2015, block-level functions were forbidden in strict mode.</p> - -<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-block', 'Block statement')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - - - -<p>{{Compat("javascript.statements.block")}}</p> - -<h2 id="Consulte_também">Consulte também</h2> - -<ul> - <li>{{jsxref("Statements/while", "while")}}</li> - <li>{{jsxref("Statements/if...else", "if...else")}}</li> - <li>{{jsxref("Statements/let", "let")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/statements/for/index.html b/files/pt-pt/web/javascript/reference/statements/for/index.html deleted file mode 100644 index 687cd23cdc..0000000000 --- a/files/pt-pt/web/javascript/reference/statements/for/index.html +++ /dev/null @@ -1,146 +0,0 @@ ---- -title: for -slug: Web/JavaScript/Reference/Statements/for -tags: - - Declaração - - Funcionalidade de Linguagem - - JavaScript - - Loop - - Referencia - - Repetição - - for -translation_of: Web/JavaScript/Reference/Statements/for -original_slug: Web/JavaScript/Reference/Extratos_e_declarações/for ---- -<div>{{jsSidebar("Statements")}}</div> - -<p>A <strong>declaração "for"</strong> cria uma repetição (<em>loop</em>) que consiste de três expressões opcionais, entre parênteses e separados por ponto e vírgula, seguido de uma declaração (normalmente <a href="/pt-PT/docs/Web/JavaScript/Reference/Extratos_e_declarações/bloco">bdeclaraçãod e bloco (<em>block</em>)</a>) para ser executada na repetição.</p> - -<div>{{EmbedInteractiveExample("pages/js/statement-for.html")}}</div> - - - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox">for ([<em>initialization</em>]; [<em>condition</em>]; [<em>final-expression</em>]) - <em>statement</em></pre> - -<dl> - <dt><code>initialization</code></dt> - <dd>An expression (including assignment expressions) or variable declaration evaluated once before the loop begins. Typically used to initialize a counter variable. This expression may optionally declare new variables with <code>var</code> or <code>let</code> keywords. Variables declared with <code>var</code> are not local to the loop, i.e. they are in the same scope the <code>for</code> loop is in. Variables declared with let are local to the statement.</dd> - <dd>The result of this expression is discarded.</dd> - <dt><code>condition</code></dt> - <dd>An expression to be evaluated before each loop iteration. If this expression evaluates to true, <code>statement</code> is executed. This conditional test is optional. If omitted, the condition always evaluates to true. If the expression evaluates to false, execution skips to the first expression following the <code>for</code> construct.</dd> - <dt><code>final-expression</code></dt> - <dd>An expression to be evaluated at the end of each loop iteration. This occurs before the next evaluation of <code>condition</code>. Generally used to update or increment the counter variable.</dd> - <dt><code>statement</code></dt> - <dd>A statement that is executed as long as the condition evaluates to true. To execute multiple statements within the loop, use a {{jsxref("Statements/block", "block", "", 0)}} statement (<code>{ ... }</code>) to group those statements. To execute no statement within the loop, use an {{jsxref("Statements/empty", "empty", "", 0)}} statement (<code>;</code>).</dd> -</dl> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Using_for">Using <code>for</code></h3> - -<p>The following <code>for</code> statement starts by declaring the variable <code>i</code> and initializing it to <code>0</code>. It checks that <code>i</code> is less than nine, performs the two succeeding statements, and increments <code>i</code> by 1 after each pass through the loop.</p> - -<pre class="brush: js">for (let i = 0; i < 9; i++) { - console.log(i); - // more statements -} -</pre> - -<h3 id="Optional_for_expressions">Optional <code>for</code> expressions</h3> - -<p>All three expressions in the head of the <code>for</code> loop are optional.</p> - -<p>For example, in the <em>initialization</em> block it is not required to initialize variables:</p> - -<pre class="brush: js">var i = 0; -for (; i < 9; i++) { - console.log(i); - // more statements -} -</pre> - -<p>Like the <em>initialization</em> block, the <em>condition</em> block is also optional. If you are omitting this expression, you must make sure to break the loop in the body in order to not create an infinite loop.</p> - -<pre class="brush: js">for (let i = 0;; i++) { - console.log(i); - if (i > 3) break; - // more statements -}</pre> - -<p>You can also omit all three blocks. Again, make sure to use a {{jsxref("Statements/break", "break")}} statement to end the loop and also modify (increase) a variable, so that the condition for the break statement is true at some point.</p> - -<pre class="brush: js">var i = 0; - -for (;;) { - if (i > 3) break; - console.log(i); - i++; -} -</pre> - -<h3 id="Using_for_without_a_statement">Using <code>for</code> without a statement</h3> - -<p>The following <code>for</code> cycle calculates the offset position of a node in the <em>final-expression</em> section, and therefore it does not require the use of a <code>statement</code> section, a semicolon is used instead.</p> - -<pre class="brush: js">function showOffsetPos(sId) { - - var nLeft = 0, nTop = 0; - - for ( - - var oItNode = document.getElementById(sId); /* initialization */ - - oItNode; /* condition */ - - nLeft += oItNode.offsetLeft, nTop += oItNode.offsetTop, oItNode = oItNode.offsetParent /* final-expression */ - - ); /* semicolon */ - - console.log('Offset position of \'' + sId + '\' element:\n left: ' + nLeft + 'px;\n top: ' + nTop + 'px;'); - -} - -/* Example call: */ - -showOffsetPos('content'); - -// Output: -// "Offset position of "content" element: -// left: 0px; -// top: 153px;"</pre> - -<div class="note"><strong>Note:</strong> This is one of the few cases in JavaScript where <strong>the semicolon is mandatory</strong>. Indeed, without the semicolon the line that follows the cycle declaration will be considered a statement.</div> - -<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-for-statement', 'for statement')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - - - -<p>{{Compat("javascript.statements.for")}}</p> - -<h2 id="Consulte_também">Consulte também</h2> - -<ul> - <li>{{jsxref("Statements/empty", "empty statement", "", 0)}}</li> - <li>{{jsxref("Statements/break", "break")}}</li> - <li>{{jsxref("Statements/continue", "continue")}}</li> - <li>{{jsxref("Statements/while", "while")}}</li> - <li>{{jsxref("Statements/do...while", "do...while")}}</li> - <li>{{jsxref("Statements/for...in", "for...in")}}</li> - <li>{{jsxref("Statements/for...of", "for...of")}}</li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/statements/index.html b/files/pt-pt/web/javascript/reference/statements/index.html deleted file mode 100644 index 723804e53a..0000000000 --- a/files/pt-pt/web/javascript/reference/statements/index.html +++ /dev/null @@ -1,151 +0,0 @@ ---- -title: Declarações e instruções -slug: Web/JavaScript/Reference/Statements -tags: - - JavaScript - - Referencia - - declarações - - instruções -translation_of: Web/JavaScript/Reference/Statements -original_slug: Web/JavaScript/Reference/Extratos_e_declarações ---- -<div>{{jsSidebar("Statements")}}</div> - -<p>JavaScript applications consist of statements with an appropriate syntax. A single statement may span multiple lines. Multiple statements may occur on a single line if each statement is separated by a semicolon. This isn't a keyword, but a group of keywords.</p> - -<h2 id="Declarações_e_instruções_por_categoria">Declarações e instruções por categoria</h2> - -<p>For an alphabetical listing see the sidebar on the left.</p> - -<h3 id="Controlo_de_Fluxo">Controlo de Fluxo</h3> - -<dl> - <dt>{{jsxref("Statements/block", "Block")}}</dt> - <dd>A block statement is used to group zero or more statements. The block is delimited by a pair of curly brackets.</dd> - <dt>{{jsxref("Statements/break", "break")}}</dt> - <dd>Terminates the current loop, switch, or label statement and transfers program control to the statement following the terminated statement.</dd> - <dt>{{jsxref("Statements/continue", "continue")}}</dt> - <dd>Terminates execution of the statements in the current iteration of the current or labeled loop, and continues execution of the loop with the next iteration.</dd> - <dt>{{jsxref("Statements/Empty", "Empty")}}</dt> - <dd>An empty statement is used to provide no statement, although the JavaScript syntax would expect one.</dd> - <dt>{{jsxref("Statements/if...else", "if...else")}}</dt> - <dd>Executes a statement if a specified condition is true. If the condition is false, another statement can be executed.</dd> - <dt>{{jsxref("Statements/switch", "switch")}}</dt> - <dd>Evaluates an expression, matching the expression's value to a case clause, and executes statements associated with that case.</dd> - <dt>{{jsxref("Statements/throw", "throw")}}</dt> - <dd>Throws a user-defined exception.</dd> - <dt>{{jsxref("Statements/try...catch", "try...catch")}}</dt> - <dd>Marks a block of statements to try, and specifies a response, should an exception be thrown.</dd> -</dl> - -<h3 id="Declarações">Declarações</h3> - -<dl> - <dt>{{jsxref("Statements/var", "var")}}</dt> - <dd>Declares a variable, optionally initializing it to a value.</dd> - <dt>{{jsxref("Statements/let", "let")}}</dt> - <dd>Declares a block scope local variable, optionally initializing it to a value.</dd> - <dt>{{jsxref("Statements/const", "const")}}</dt> - <dd>Declares a read-only named constant.</dd> -</dl> - -<h3 id="Funções_e_classes">Funções e classes</h3> - -<dl> - <dt>{{jsxref("Statements/function", "function")}}</dt> - <dd>Declara as funções com parâmetros especificados.</dd> - <dt>{{jsxref("Statements/function*", "function*")}}</dt> - <dd>Generators functions enable writing <a href="/en-US/docs/Web/JavaScript/Guide/The_Iterator_protocol">iterators</a> more easily.</dd> - <dt>{{jsxref("Statements/async_function", "async function")}}</dt> - <dd>Declares an async function with the specified parameters.</dd> - <dt>{{jsxref("Statements/return", "return")}}</dt> - <dd>Specifies the value to be returned by a function.</dd> - <dt>{{jsxref("Statements/class", "class")}}</dt> - <dd>Declara uma Classe.</dd> -</dl> - -<h3 id="Iterações">Iterações</h3> - -<dl> - <dt>{{jsxref("Statements/do...while", "do...while")}}</dt> - <dd>Creates a loop that executes a specified statement until the test condition evaluates to false. The condition is evaluated after executing the statement, resulting in the specified statement executing at least once.</dd> - <dt>{{jsxref("Statements/for", "for")}}</dt> - <dd>Creates a loop that consists of three optional expressions, enclosed in parentheses and separated by semicolons, followed by a statement executed in the loop.</dd> - <dt>{{deprecated_inline}} {{non-standard_inline()}} {{jsxref("Statements/for_each...in", "for each...in")}}</dt> - <dd>Iterates a specified variable over all values of object's properties. For each distinct property, a specified statement is executed.</dd> - <dt>{{jsxref("Statements/for...in", "for...in")}}</dt> - <dd>Iterates over the enumerable properties of an object, in arbitrary order. For each distinct property, statements can be executed.</dd> - <dt>{{jsxref("Statements/for...of", "for...of")}}</dt> - <dd>Iterates over iterable objects (including {{jsxref("Global_Objects/Array","arrays","","true")}}, array-like objects, <a href="/en-US/docs/JavaScript/Guide/Iterators_and_Generators">iterators and generators</a>), invoking a custom iteration hook with statements to be executed for the value of each distinct property.</dd> - <dt>{{jsxref("Statements/while", "while")}}</dt> - <dd>Creates a loop that executes a specified statement as long as the test condition evaluates to true. The condition is evaluated before executing the statement.</dd> -</dl> - -<h3 id="Outros">Outros</h3> - -<dl> - <dt>{{jsxref("Statements/debugger", "debugger")}}</dt> - <dd>Invokes any available debugging functionality. If no debugging functionality is available, this statement has no effect.</dd> - <dt>{{jsxref("Statements/export", "export")}}</dt> - <dd>Used to export functions to make them available for imports in external modules, another scripts.</dd> - <dt>{{jsxref("Statements/import", "import")}}</dt> - <dd>Used to import functions exported from an external module, another script.</dd> - <dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import.meta">import.meta</a></code></dt> - <dd>A meta-property exposing context-specific metadata to a JavaScript module.</dd> - <dt>{{jsxref("Statements/label", "label")}}</dt> - <dd>Provides a statement with an identifier that you can refer to using a <code>break</code> or <code>continue</code> statement.</dd> -</dl> - -<dl> - <dt>{{deprecated_inline}} {{jsxref("Statements/with", "with")}}</dt> - <dd>Extends the scope chain for a statement.</dd> -</dl> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1', '#sec-12', 'Statements')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition</td> - </tr> - <tr> - <td>{{SpecName('ES3', '#sec-12', 'Statements')}}</td> - <td>{{Spec2('ES3')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-12', 'Statements')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-ecmascript-language-statements-and-declarations', 'ECMAScript Language: Statements and Declarations')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>New: function*, let, for...of, yield, class</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-ecmascript-language-statements-and-declarations', 'ECMAScript Language: Statements and Declarations')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - - - -<p>{{Compat("javascript.statements")}}</p> - -<h2 id="Consultar_também">Consultar também</h2> - -<ul> - <li><a href="/pt-PT/docs/Web/JavaScript/Reference/Operadores">Operadores</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/statements/return/index.html b/files/pt-pt/web/javascript/reference/statements/return/index.html deleted file mode 100644 index 54d99d85c3..0000000000 --- a/files/pt-pt/web/javascript/reference/statements/return/index.html +++ /dev/null @@ -1,149 +0,0 @@ ---- -title: return -slug: Web/JavaScript/Reference/Statements/return -tags: - - Declaração - - JavaScript -translation_of: Web/JavaScript/Reference/Statements/return -original_slug: Web/JavaScript/Reference/Extratos_e_declarações/return ---- -<div>{{jsSidebar("Statements")}}</div> - -<p>The <strong><code>return</code> statement</strong> ends function execution and specifies a value to be returned to the function caller.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox">return [[expression]]; </pre> - -<dl> - <dt><code>expression</code></dt> - <dd>The expression whose value is to be returned. If omitted, <code>undefined</code> is returned instead.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>When a <code>return</code> statement is used in a function body, the execution of the function is stopped. If specified, a given value is returned to the function caller. For example, the following function returns the square of its argument, <code>x</code>, where <code>x</code> is a number.</p> - -<pre class="brush: js">function square(x) { - return x * x; -} -var demo = square(3); -// demo will equal 9 -</pre> - -<p>If the value is omitted, <code>undefined</code> is returned instead.</p> - -<p>The following return statements all break the function execution:</p> - -<pre class="brush: js">return; -return true; -return false; -return x; -return x + y / 3; -</pre> - -<h3 id="Inserção_Automática_de_Ponto_e_Vírgula">Inserção Automática de Ponto e Vírgula</h3> - -<p>The <code>return</code> statement is affected by <a href="/en-US/docs/Web/JavaScript/Reference/Lexical_grammar#Automatic_semicolon_insertion">automatic semicolon insertion (ASI)</a>. No line terminator is allowed between the <code>return</code> keyword and the expression.</p> - -<pre class="brush: js">return -a + b; -</pre> - -<p>is transformed by ASI into:</p> - -<pre>return; -a + b; -</pre> - -<p>The console will warn "unreachable code after return statement".</p> - -<div class="note">Starting with Gecko 40 {{geckoRelease(40)}}, a warning is shown in the console if unreachable code is found after a return statement.</div> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Interromper_uma_função">Interromper uma função</h3> - -<p>A function immediately stops at the point where <code>return</code> is called.</p> - -<pre class="brush: js">function counter() { - for (var count = 1; ; count++) { // infinite loop - console.log(count + 'A'); // until 5 - if (count === 5) { - return; - } - console.log(count + 'B'); // until 4 - } - console.log(count + 'C'); // never appears -} - -counter(); - -// Output: -// 1A -// 1B -// 2A -// 2B -// 3A -// 3B -// 4A -// 4B -// 5A -</pre> - -<h3 id="Devolver_uma_função">Devolver uma função</h3> - -<p>See also the article about <a href="/en-US/docs/Web/JavaScript/Closures">Closures</a>.</p> - -<pre class="brush: js">function magic(x) { - return function calc(x) { return x * 42; }; -} - -var answer = magic(); -answer(1337); // 56154 -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-12.9', 'Return statement')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-return-statement', 'Return statement')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-return-statement', 'Return statement')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - - - -<p>{{Compat("javascript.statements.return")}}</p> - -<h2 id="Consulte_também">Consulte também</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions_and_function_scope" title="En/Core_JavaScript_1.5_Reference/Functions">Functions</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Closures">Closures</a></li> -</ul> diff --git a/files/pt-pt/web/javascript/reference/statements/throw/index.html b/files/pt-pt/web/javascript/reference/statements/throw/index.html deleted file mode 100644 index 59a0e32938..0000000000 --- a/files/pt-pt/web/javascript/reference/statements/throw/index.html +++ /dev/null @@ -1,272 +0,0 @@ ---- -title: throw -slug: Web/JavaScript/Reference/Statements/throw -tags: - - Comando - - Declaração - - JavaScript -translation_of: Web/JavaScript/Reference/Statements/throw -original_slug: Web/JavaScript/Reference/Extratos_e_declarações/throw ---- -<div>{{jsSidebar("Statements")}}</div> - -<p>A <strong>declaração <code>throw</code> </strong>lança uma exeção definida pelo utilizador. A execução da função atual irá parar (os comandos depois de <code>throw</code> não serão executados), <span id="result_box" lang="pt"><span>e o controle será passado para o primeiro bloco <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch">catch</a></code> no conjunto de chamadas. Se não existir nenhum bloco <code>catch</code> entre as funções de <em>caller</em>, o programa irá terminar.</span></span></p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox">expressão throw; </pre> - -<dl> - <dt><code>expressão</code></dt> - <dd>A expressão para <em>throw</em>.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>Use the <code>throw</code> statement to throw an exception. When you throw an exception, <code>expression</code> specifies the value of the exception. Each of the following throws an exception:</p> - -<pre class="brush: js">throw 'Error2'; // generates an exception with a string value -throw 42; // generates an exception with the value 42 -throw true; // generates an exception with the value true</pre> - -<p>Also note that the <code>throw</code> statement is affected by <a href="/en-US/docs/Web/JavaScript/Reference/Lexical_grammar#Automatic_semicolon_insertion">automatic semicolon insertion (ASI)</a> as no line terminator between the <code>throw</code> keyword and the expression is allowed.</p> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Throw_um_objeto">Throw um objeto</h3> - -<p>You can specify an object when you throw an exception. You can then reference the object's properties in the <code>catch</code> block. The following example creates an object of type <code>UserException</code> and uses it in a <code>throw</code> statement.</p> - -<pre class="brush: js">function UserException(message) { - this.message = message; - this.name = 'UserException'; -} -function getMonthName(mo) { - mo = mo - 1; // Adjust month number for array index (1 = Jan, 12 = Dec) - var months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', - 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']; - if (months[mo] !== undefined) { - return months[mo]; - } else { - throw new UserException('InvalidMonthNo'); - } -} - -try { - // statements to try - var myMonth = 15; // 15 is out of bound to raise the exception - var monthName = getMonthName(myMonth); -} catch (e) { - monthName = 'unknown'; - console.log(e.message, e.name); // pass exception object to err handler -} -</pre> - -<h3 id="Outro_exemplo_de_throwing_um_objeto">Outro exemplo de <em>throwing</em> um objeto</h3> - -<p>The following example tests an input string for a U.S. zip code. If the zip code uses an invalid format, the throw statement throws an exception by creating an object of type <code>ZipCodeFormatException</code>.</p> - -<pre class="brush: js">/* - * Creates a ZipCode object. - * - * Accepted formats for a zip code are: - * 12345 - * 12345-6789 - * 123456789 - * 12345 6789 - * - * If the argument passed to the ZipCode constructor does not - * conform to one of these patterns, an exception is thrown. - */ - -function ZipCode(zip) { - zip = new String(zip); - pattern = /[0-9]{5}([- ]?[0-9]{4})?/; - if (pattern.test(zip)) { - // zip code value will be the first match in the string - this.value = zip.match(pattern)[0]; - this.valueOf = function() { - return this.value - }; - this.toString = function() { - return String(this.value) - }; - } else { - throw new ZipCodeFormatException(zip); - } -} - -function ZipCodeFormatException(value) { - this.value = value; - this.message = 'does not conform to the expected format for a zip code'; - this.toString = function() { - return this.value + this.message; - }; -} - -/* - * This could be in a script that validates address data - * for US addresses. - */ - -const ZIPCODE_INVALID = -1; -const ZIPCODE_UNKNOWN_ERROR = -2; - -function verifyZipCode(z) { - try { - z = new ZipCode(z); - } catch (e) { - if (e instanceof ZipCodeFormatException) { - return ZIPCODE_INVALID; - } else { - return ZIPCODE_UNKNOWN_ERROR; - } - } - return z; -} - -a = verifyZipCode(95060); // returns 95060 -b = verifyZipCode(9560); // returns -1 -c = verifyZipCode('a'); // returns -1 -d = verifyZipCode('95060'); // returns 95060 -e = verifyZipCode('95060 1234'); // returns 95060 1234 -</pre> - -<h3 id="Rethrow_uma_exceção"><em>Rethrow</em> uma exceção</h3> - -<p>You can use <code>throw</code> to rethrow an exception after you catch it. The following example catches an exception with a numeric value and rethrows it if the value is over 50. The rethrown exception propagates up to the enclosing function or to the top level so that the user sees it.</p> - -<pre class="brush: js">try { - throw n; // throws an exception with a numeric value -} catch (e) { - if (e <= 50) { - // statements to handle exceptions 1-50 - } else { - // cannot handle this exception, so rethrow - throw e; - } -} -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Initial definition. Implemented in JavaScript 1.4</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-12.13', 'throw statement')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-throw-statement', 'throw statement')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-throw-statement', 'throw statement')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2> - - - -<p>{{Compat("javascript.statements.throw")}}</p> - -<h2 id="Consulte_também">Consulte também</h2> - -<ul> - <li><a href="/pt-PT/docs/Web/JavaScript/Reference/Extratos_e_declarações/try...catch"><code>try...catch</code></a></li> -</ul> - -<div id="SL_balloon_obj" style="display: block;"> -<div class="SL_ImTranslatorLogo" id="SL_button" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%; opacity: 0; display: block; left: -8px; top: -25px; transition: visibility 2s ease 0s, opacity 2s linear 0s;"> </div> - -<div id="SL_shadow_translation_result2" class="hidden"> </div> - -<div id="SL_shadow_translator" class="hidden"> -<div id="SL_planshet"> -<div id="SL_arrow_up" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%;"> </div> - -<div id="SL_Bproviders"> -<div class="SL_BL_LABLE_ON" id="SL_P0" title="Google">G</div> - -<div class="SL_BL_LABLE_ON" id="SL_P1" title="Microsoft">M</div> - -<div class="SL_BL_LABLE_ON" id="SL_P2" title="Translator">T</div> -</div> - -<div id="SL_alert_bbl" class="hidden"> -<div id="SLHKclose" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%;"> </div> - -<div id="SL_alert_cont"> </div> -</div> - -<div id="SL_TB"> -<table id="SL_tables"> - <tbody><tr> - <td class="SL_td"><input></td> - <td class="SL_td"><select><option value="auto">Detectar idioma</option><option value="af">Africâner</option><option value="sq">Albanês</option><option value="de">Alemão</option><option value="ar">Arabe</option><option value="hy">Armênio</option><option value="az">Azerbaijano</option><option value="eu">Basco</option><option value="bn">Bengali</option><option value="be">Bielo-russo</option><option value="my">Birmanês</option><option value="bs">Bósnio</option><option value="bg">Búlgaro</option><option value="ca">Catalão</option><option value="kk">Cazaque</option><option value="ceb">Cebuano</option><option value="ny">Chichewa</option><option value="zh-CN">Chinês (Simp)</option><option value="zh-TW">Chinês (Trad)</option><option value="si">Cingalês</option><option value="ko">Coreano</option><option value="ht">Crioulo haitiano</option><option value="hr">Croata</option><option value="da">Dinamarquês</option><option value="sk">Eslovaco</option><option value="sl">Esloveno</option><option value="es">Espanhol</option><option value="eo">Esperanto</option><option value="et">Estoniano</option><option value="fi">Finlandês</option><option value="fr">Francês</option><option value="gl">Galego</option><option value="cy">Galês</option><option value="ka">Georgiano</option><option value="el">Grego</option><option value="gu">Gujarati</option><option value="ha">Hauça</option><option value="iw">Hebraico</option><option value="hi">Hindi</option><option value="hmn">Hmong</option><option value="nl">Holandês</option><option value="hu">Húngaro</option><option value="ig">Igbo</option><option value="id">Indonésio</option><option value="en">Inglês</option><option value="yo">Ioruba</option><option value="ga">Irlandês</option><option value="is">Islandês</option><option value="it">Italiano</option><option value="ja">Japonês</option><option value="jw">Javanês</option><option value="kn">Kannada</option><option value="km">Khmer</option><option value="lo">Laosiano</option><option value="la">Latim</option><option value="lv">Letão</option><option value="lt">Lituano</option><option value="mk">Macedônico</option><option value="ml">Malaiala</option><option value="ms">Malaio</option><option value="mg">Malgaxe</option><option value="mt">Maltês</option><option value="mi">Maori</option><option value="mr">Marathi</option><option value="mn">Mongol</option><option value="ne">Nepalês</option><option value="no">Norueguês</option><option value="fa">Persa</option><option value="pl">Polonês</option><option value="pt">Português</option><option value="pa">Punjabi</option><option value="ro">Romeno</option><option value="ru">Russo</option><option value="sr">Sérvio</option><option value="st">Sesotho</option><option value="so">Somália</option><option value="sw">Suaíli</option><option value="su">Sudanês</option><option value="sv">Sueco</option><option value="tg">Tadjique</option><option value="tl">Tagalo</option><option value="th">Tailandês</option><option value="ta">Tâmil</option><option value="cs">Tcheco</option><option value="te">Telugo</option><option value="tr">Turco</option><option value="uk">Ucraniano</option><option value="ur">Urdu</option><option value="uz">Uzbeque</option><option value="vi">Vietnamita</option><option value="yi">Yiddish</option><option value="zu">Zulu</option></select></td> - <td class="SL_td"> - <div id="SL_switch_b" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%;" title="Alternar Idiomas"> </div> - </td> - <td class="SL_td"><select><option value="af">Africâner</option><option value="sq">Albanês</option><option value="de">Alemão</option><option value="ar">Arabe</option><option value="hy">Armênio</option><option value="az">Azerbaijano</option><option value="eu">Basco</option><option value="bn">Bengali</option><option value="be">Bielo-russo</option><option value="my">Birmanês</option><option value="bs">Bósnio</option><option value="bg">Búlgaro</option><option value="ca">Catalão</option><option value="kk">Cazaque</option><option value="ceb">Cebuano</option><option value="ny">Chichewa</option><option value="zh-CN">Chinês (Simp)</option><option value="zh-TW">Chinês (Trad)</option><option value="si">Cingalês</option><option value="ko">Coreano</option><option value="ht">Crioulo haitiano</option><option value="hr">Croata</option><option value="da">Dinamarquês</option><option value="sk">Eslovaco</option><option value="sl">Esloveno</option><option value="es">Espanhol</option><option value="eo">Esperanto</option><option value="et">Estoniano</option><option value="fi">Finlandês</option><option value="fr">Francês</option><option value="gl">Galego</option><option value="cy">Galês</option><option value="ka">Georgiano</option><option value="el">Grego</option><option value="gu">Gujarati</option><option value="ha">Hauça</option><option value="iw">Hebraico</option><option value="hi">Hindi</option><option value="hmn">Hmong</option><option value="nl">Holandês</option><option value="hu">Húngaro</option><option value="ig">Igbo</option><option value="id">Indonésio</option><option selected value="en">Inglês</option><option value="yo">Ioruba</option><option value="ga">Irlandês</option><option value="is">Islandês</option><option value="it">Italiano</option><option value="ja">Japonês</option><option value="jw">Javanês</option><option value="kn">Kannada</option><option value="km">Khmer</option><option value="lo">Laosiano</option><option value="la">Latim</option><option value="lv">Letão</option><option value="lt">Lituano</option><option value="mk">Macedônico</option><option value="ml">Malaiala</option><option value="ms">Malaio</option><option value="mg">Malgaxe</option><option value="mt">Maltês</option><option value="mi">Maori</option><option value="mr">Marathi</option><option value="mn">Mongol</option><option value="ne">Nepalês</option><option value="no">Norueguês</option><option value="fa">Persa</option><option value="pl">Polonês</option><option value="pt">Português</option><option value="pa">Punjabi</option><option value="ro">Romeno</option><option value="ru">Russo</option><option value="sr">Sérvio</option><option value="st">Sesotho</option><option value="so">Somália</option><option value="sw">Suaíli</option><option value="su">Sudanês</option><option value="sv">Sueco</option><option value="tg">Tadjique</option><option value="tl">Tagalo</option><option value="th">Tailandês</option><option value="ta">Tâmil</option><option value="cs">Tcheco</option><option value="te">Telugo</option><option value="tr">Turco</option><option value="uk">Ucraniano</option><option value="ur">Urdu</option><option value="uz">Uzbeque</option><option value="vi">Vietnamita</option><option value="yi">Yiddish</option><option value="zu">Zulu</option></select></td> - <td class="SL_td"> - <div id="SL_TTS_voice" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%;" title="Ouça"> </div> - </td> - <td class="SL_td"> - <div class="SL_copy" id="SL_copy" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%;" title="Copiar"> </div> - </td> - <td class="SL_td"> - <div id="SL_bbl_font_patch"> </div> - - <div class="SL_bbl_font" id="SL_bbl_font" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%;" title="Tamanho da fonte"> </div> - </td> - <td class="SL_td"> - <div id="SL_bbl_help" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%;" title="Ajuda"> </div> - </td> - <td class="SL_td"> - <div class="SL_pin_off" id="SL_pin" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%;" title="Fixar a janela de pop-up"> </div> - </td> - </tr> -</tbody></table> -</div> -</div> - -<div id="SL_shadow_translation_result" style=""> </div> - -<div class="SL_loading" id="SL_loading" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%;"> </div> - -<div id="SL_player2"> </div> - -<div id="SL_alert100">A função de fala é limitada a 200 caracteres</div> - -<div id="SL_Balloon_options" style="background: rgb(255, 255, 255) repeat scroll 0% 0%;"> -<div id="SL_arrow_down" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%;"> </div> - -<table id="SL_tbl_opt" style="width: 100%;"> - <tbody><tr> - <td><input></td> - <td> - <div id="SL_BBL_IMG" style="background: rgba(0, 0, 0, 0) repeat scroll 0% 0%;" title="Mostrar o botão do ImTranslator 3 segundos"> </div> - </td> - <td><a class="SL_options" title="Mostrar opções">Opções</a> : <a class="SL_options" title="Histórico de tradução">Histórico</a> : <a class="SL_options" title="Comentários">Comentários</a> : <a class="SL_options" href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=GD9D8CPW8HFA2" title="Faça sua contribuição">Donate</a></td> - <td><span id="SL_Balloon_Close" title="Encerrar">Encerrar</span></td> - </tr> -</tbody></table> -</div> -</div> -</div> |