Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Function.prototype e a propriedade prototype de uma função

As funções herdam os métodos de invocação de `Function.prototype`. Com um `new Ctor()` comum, o valor de `Ctor.prototype` só se torna o protótipo da nova instância se for um objeto.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

Function.prototype
fn.call(thisArg, ...args)
fn.apply(thisArg, argArray)
fn.bind(thisArg, ...args)
Ctor.prototype
Object.getPrototypeOf(fn)
Object.getPrototypeOf(instance)

Function.prototype é um objeto partilhado nas cadeias de protótipos das funções. Uma declaração comum function Ctor() {} cria uma função para a qual Object.getPrototypeOf(Ctor) === Function.prototype. O próprio Function.prototype é invocável e devolve undefined, mas não suporta new.

A propriedade própria Ctor.prototype de uma função (a propriedade de protótipo de instância da função) tem um papel diferente: com um new Ctor() comum, o seu valor só se torna o protótipo interno da instância criada se for um objeto. Se o valor for primitivo, incluindo null, é usado em seu lugar o Object.prototype intrínseco do ambiente de execução (realm) do construtor. Ctor.prototype não determina o protótipo da própria função Ctor. O objeto Ctor.prototype predefinido tem uma propriedade constructor que aponta para Ctor.

Function.prototype.call invoca uma função com o thisArg indicado e argumentos separados; Function.prototype.apply aceita os argumentos como um objeto semelhante a um array. Function.prototype.bind não invoca a função imediatamente: cria uma nova função com um thisArg fixo e, opcionalmente, argumentos iniciais. Estes métodos não podem alterar o this léxico de uma função arrow.

A presença de .prototype não prova que new seja suportado: os geradores têm esta propriedade, mas não são construtores. As funções arrow não a têm por predefinição. Uma função associada com bind também não tem um .prototype próprio, mas pode suportar new se a função-alvo for um construtor; nesse caso, o thisArg associado é ignorado.

Exemplos

"use strict";

function Counter(value) {
  this.value = value;
}

Counter.prototype.add = function (amount) {
  return this.value + amount;
};

const counter = new Counter(10);
const add = Counter.prototype.add;
const addTwo = add.bind(counter, 2);

console.log(Object.getPrototypeOf(Counter) === Function.prototype);
console.log(Object.getPrototypeOf(counter) === Counter.prototype);
console.log(Counter.prototype === Function.prototype);
console.log(add.call(counter, 2));
console.log(add.apply(counter, [2]));
console.log(addTwo());

Resultado

true
true
false
12
12
12

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes