TL;DR
É impossível tornar uma instância de Map
imutável em JavaScript.
Antes de tudo, é preciso esclarecer algumas coisas.
Todos os mecanismos utilizados na pergunta para tornar um objeto "imutável" são apenas válidos para objetos, de modo que podemos definir propriedades imutáveis:
Object.defineProperty
permite a definição de uma propriedade com atributos customizados. De modo, você pode definir uma propriedade com [[Writable]]
e [[Configurable]]
false
s, tornando-a imutável.
Ou modificar o comportamento de um objeto já existente:
Object.freeze
, o suprassumo dos três, essencialmente, torna um objeto imutável, de modo que:
- Previne a modificação de suas propriedades;
- Previne a remoção de suas propriedades; e:
- Previne a adição de novas propriedades.
Object.seal
, similar ao Object.freeze
, mas um pouco menos rigoroso, já que ainda permite a modificação de propriedades já existentes. Então:
- Previne a remoção de suas propriedades; e:
- Previne a adição de novas propriedades.
Object.preventExtensions
, que apenas previne a adição de novas propriedades. É o mais fraquinho dos três.
Mas repare que esses quatro mecanismos trabalham exclusivamente sobre objetos, atuando sobre os descritores de propriedade. Somente a adição de novas propriedades que não tem a ver com os descritores, mas sim com a propriedade interna [[Extensible]]
, que faz parte de um objeto (e não de suas propriedades, tal como os atributos de propriedade).
Desse modo, não é esperado que esses quatro mecanismos funcionem para imutabilizar instâncias de Map
.
Para entender melhor, vamos comparar as formas como objetos e mapas (instâncias de Map
) armazenam seus valores.
Objetos |
Instâncias de Map |
Armazenam seus valores, qualificados por uma chave, como uma propriedade do próprio objeto. |
Armazenam seus valores, qualificados por uma chave, como um "membro" do "armazém" interno de cada Map . |
Portanto, ao contrário de objetos, cujos valores armazenados podem ser acessados pelo programador (através de APIs do próprio JavaScript), os valores de mapas são mantidos em um "armazém" protegido do programador. Você pode saber mais sobre esse internal store dos mapas na seção § 23.1, sobre Map
, na especificação da linguagem. É bem esclarecedor.
Isso significa que, a partir das APIs do JavaScript, é impossível tornar, de fato, algum membro de um mapa imutável.
O que poderia ser feito é criar uma "subclasse"1 de Map
chamada ImmutableMap
que, ao sobrescrever o método set
, impede qualquer tipo de modificação em valores. Ademais, valores só podem ser adicionados na construção.
class ImmutableMap extends Map {
constructor(initialEntries) {
super();
for (const [key, val] of initialEntries) {
super.set(key, val);
}
}
// Sobrescreve o método `set`:
set() {
console.log('This map is readonly.');
// Não vou lançar erro para fins didáticos, mas seria de bom tom:
// throw new TypeError('Attempted to mutate a readonly map.');
}
}
const imap = new ImmutableMap([
['name', 'Luiz Felipe'],
['publicUserId', 'lffg']
]);
console.log(imap.get('name')); //=> 'Luiz Felipe'
imap.set('name', 'Luiz Felipe 2'); //=> This map is readonly.
console.log(imap.get('name')); //=> 'Luiz Felipe'
Claro que realmente a utilidade disso me parece mínima, mas a ideia é essa.
É interessante mencionar, também, que nada disso realmente funciona para tornar uma instância de Map
(ou ImmutableMap
, que implementamos acima) realmente imutável, já que o pode-se utilizar o método Map.prototype.set
com this
sendo a instância modificada. Para isso, pode-se utilizar Function.prototype.call
ou Function.prototype.apply
.
As três últimas linhas deste exemplo demonstram isso. Queira verificar:
class ImmutableMap extends Map {
constructor(initialEntries) {
super();
for (const [key, val] of initialEntries) {
super.set(key, val);
}
}
// Sobrescreve o método `set`:
set() {
console.log('This map is readonly.');
// Não vou lançar erro para fins didáticos, mas seria de bom tom:
// throw new TypeError('Attempted to mutate a readonly map.');
}
}
const imap = new ImmutableMap([
['name', 'Luiz Felipe'],
['publicUserId', 'lffg']
]);
console.log(imap.get('name')); //=> 'Luiz Felipe'
imap.set('name', 'Luiz Felipe 2'); //=> This map is readonly.
console.log(imap.get('name')); //=> 'Luiz Felipe'
// CONTRA ISTO NÃO HÁ ESCAPATÓRIA.
Map.prototype.set.call(imap, 'name', 'Luiz Felipe 3');
console.log(imap.get('name')); //=> 'Luiz Felipe 3'
Nem o monkey patch, sugerido nos comentários, resolveria essa limitação. É uma limitação que se deve ao fato de que não temos próprio acesso ao store do mapa.
Ah! O a natureza prototípica do JavaScript nos atrapalhando. Mas quem se importa, né? :-)
Em suma, é válido concluir que é impossível tornar um mapa imutável em JavaScript.
A única "solução" que vejo para isso é criar uma implementação completamente diferente, que usa um Map
internamente como detalhe de implementação. Mas nesse caso, para ser justo, nem se trata mais de uma instância de Map
. É um objeto completamente diferente. Então não acho que funciona como resposta. De todo modo, a ideia está aí.
Rodapé
Nota 1: Coloquei entre aspas porque a orientação a objetos do JavaScript não é clássica, mas sim prototípica.
map.set = ()=> undefined;
seguido deObject.freeze(map);
não soluciona?Object.freeze
nomap
não tem nenhum efeito sobre o que de fato está sendo armazenado no mapa. Mas o monkey patch, de fato, é uma solução para um mapa já instanciado viaMap
.map.set = ()=> undefined;
ele para de inserir dados nomap
e Object.freeze(map); impede que a restauração seja feita tornado o read only.Object.freeze(map)
. Bom complemento! :DMap.prototype.set.call(map,'foo','123');
a alteração é realizada.