Object.preventExtensions — impedir novas propriedades
Object.preventExtensions(obj) impede de forma irreversível a adição de propriedades próprias a um objeto e devolve esse mesmo objeto. Não congela os valores existentes nem os objetos aninhados.
CKTIS / JavaScript
Sintaxe, operadores e conceitos de programação. Encontra uma explicação, consulta um exemplo e continua a aprender.
Object.preventExtensions(obj) impede de forma irreversível a adição de propriedades próprias a um objeto e devolve esse mesmo objeto. Não congela os valores existentes nem os objetos aninhados.
Object.prototype.constructor é uma propriedade de dados cujo valor inicial é a função Object. Os objetos normalmente herdam constructor de um protótipo, mas a propriedade pode ser ocultada e, por isso, não é uma forma fiável de identificar um tipo.
Object.prototype.hasOwnProperty() verifica se uma propriedade pertence diretamente a um objeto, em vez de pertencer ao respetivo protótipo. Aprende em que difere de `in` e como a chamar em segurança quando o método está substituído.
Object.seal impede a adição e a eliminação de propriedades próprias de um objeto, mas não o torna imutável. Num objeto ordinário, as propriedades de dados que permitem escrita podem continuar a receber novos valores, e os objetos aninhados não são selados automaticamente.
Num objeto comum, uma chamada bem-sucedida a `Object.setPrototypeOf(obj, proto)` define o protótipo interno sem copiar propriedades e devolve o mesmo objeto. `proto` tem de ser um objeto ou `null`. Se um `Proxy` tiver um objeto-alvo extensível, o seu intersetor `setPrototypeOf` pode indicar que a operação foi bem-sucedida sem alterar o protótipo do alvo. A chamada devolve, ainda assim, o `Proxy` original.
Object.values(obj) devolve um novo array com os valores das propriedades próprias e enumeráveis cujas chaves são cadeias de caracteres. Exclui propriedades herdadas ou não enumeráveis e chaves Symbol.
Promise.all devolve uma única promessa para todos os elementos de um objeto iterável. Se a iteração terminar sem erros e todos os elementos produzirem um valor, a promessa é cumprida com um array de resultados pela ordem de entrada. A primeira rejeição observada entre as promessas de entrada leva à rejeição da promessa conjunta. Uma exceção lançada durante a iteração também pode causar a sua rejeição, mesmo que nenhuma promessa de entrada seja rejeitada. O método não cancela as restantes operações.
Promise.allSettled aceita um objeto iterável e devolve uma promessa com um array dos resultados de todos os elementos. Mantém a ordem de entrada e regista tanto os valores das promessas cumpridas como os motivos das rejeições.
Promise.any aceita um objeto iterável e devolve uma promise cumprida com o primeiro resultado bem-sucedido que o método observa. As rejeições das entradas não terminam a espera, a menos que todas sejam rejeitadas; nesse caso, o resultado é rejeitado com AggregateError.
O método catch() associa um tratador de rejeições a uma promise. Permite recuperar, devolvendo um valor de sucesso, ou propagar uma falha e, com o método then padrão, devolve uma nova promise.
Promise.prototype.finally executa uma função depois de uma promessa ser cumprida ou rejeitada. Permite fazer uma limpeza comum que normalmente preserva o resultado original, embora uma falha na limpeza o possa substituir.
Promise.prototype.then regista funções de tratamento para a conclusão ou rejeição e devolve uma nova promise. O resultado da função de tratamento determina como a cadeia prossegue.
Promise.race(iterable) devolve uma promessa que adota o valor de cumprimento ou o motivo de rejeição do primeiro desfecho processado. Não espera pelo primeiro sucesso nem cancela as restantes operações.
Promise.reject(reason) cria uma nova promise rejeitada com o motivo indicado. Os handlers de rejeição são executados de forma assíncrona, embora a promise devolvida já esteja rejeitada quando é devolvida.
Promise.resolve(value) permite tratar um valor comum, uma promessa ou um thenable como uma promessa. Pode devolver uma promessa existente sem a alterar; resolved não significa que o resultado já esteja disponível nem que a operação seja bem-sucedida.
Promise.withResolvers() devolve uma nova promise e as funções resolve e reject associadas. Permite separar a criação da promise da indicação do seu resultado, por exemplo, ao adaptar uma interface baseada em callbacks.
Proxy cria um objeto que medeia operações sobre um objeto de destino. Os métodos handler.get e handler.set permitem calcular valores durante a leitura e controlar escritas, respeitando os invariantes da linguagem.
RangeError é um tipo de erro integrado no ECMAScript que indica um valor fora de um conjunto ou intervalo permitido. Permite assinalar argumentos inválidos e tratar estas exceções com try...catch.
ReferenceError é um tipo de erro JavaScript integrado, gerado, entre outros casos, ao ler um nome não resolvido ou uma variável antes da sua inicialização. Saiba como uma variável inexistente difere de undefined e por que razão typeof não contorna as regras de inicialização.
Reflect.apply chama uma função com o valor de `this` fornecido e argumentos lidos de um objeto passado à chamada. Devolve o resultado da função sem ler a propriedade `apply` desta.
Reflect.construct invoca um construtor com argumentos lidos de um objeto. O newTarget opcional permite separar o construtor executado do valor de new.target e da escolha habitual do protótipo.
Reflect.defineProperty define ou altera uma propriedade própria de um objeto através de um descritor. Devolve true ou false, mas não garante uma execução sem exceções.
Reflect.deleteProperty(target, propertyKey) tenta eliminar uma propriedade própria de um objeto e devolve um resultado booleano. Para um objeto comum, devolve true mesmo quando a propriedade não existe e false quando tem configurable: false.
`Reflect.get` lê uma propriedade de um objeto, incluindo uma propriedade herdada. Numa pesquisa normal, o receiver é passado ao getter como argumento `this`, sem alterar o ponto de partida da pesquisa.