O Metamétodo __newindex

Você aprendeu como __index controla o que acontece quando você tenta ler uma chave que não existe em uma tabela. Agora você descobrirá sua contraparte: __newindex, que controla o que acontece quando você tenta adicionar ou modificar um par chave-valor.

O metamétodo __newindex é acionado sempre que você tenta atribuir um valor a uma chave que não existe atualmente na tabela. Isso lhe dá o poder de interceptar e controlar modificações antes que elas ocorram.

Aqui está um exemplo simples que impede que novas chaves sejam adicionadas a uma tabela:

local readOnly = {}
local meta = {
    __newindex = function(table, key, value)
        print("Cannot add key: " .. key)
    end
}

setmetatable(readOnly, meta)

readOnly.name = "Alice"  -- Saída: Cannot add key: name
print(readOnly.name)     -- Saída: nil

Quando você tenta definir readOnly.name = "Alice", o Lua vê que name não existe na tabela. Em vez de adicioná-lo, o Lua chama a função __newindex com três argumentos: a própria tabela, a chave que está sendo definida e o valor que está sendo atribuído.

Neste exemplo, a função simplesmente imprime uma mensagem e não armazena nada de fato.

Você também pode usar __newindex para validar dados antes de permiti-los em sua tabela:

local player = {}
local meta = {
    __newindex = function(t, key, value)
        if key == "health" and type(value) ~= "number" then
            print("Health must be a number!")
        else
            rawset(t, key, value)
        end
    end
}

setmetatable(player, meta)

player.health = "high"  -- Saída: Health must be a number!
player.health = 100     -- Permitido

Observe o uso de rawset() no segundo exemplo. Esta função ignora a metatable e define o valor diretamente na tabela.

Sem isso, definir o valor dispararia __newindex novamente, criando um loop infinito.