El metamétodo __newindex

Has aprendido cómo __index controla lo que sucede cuando intentas leer una clave que no existe en una tabla. Ahora descubrirás su contraparte: __newindex, que controla lo que sucede cuando intentas añadir o modificar un par clave-valor.

El metamétodo __newindex se activa cada vez que intentas asignar un valor a una clave que no existe actualmente en la tabla. Esto te da el poder de interceptar y controlar las modificaciones antes de que ocurran.

Aquí tienes un ejemplo sencillo que evita que se añadan nuevas claves a una tabla:

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

setmetatable(readOnly, meta)

readOnly.name = "Alice"  -- Salida: Cannot add key: name
print(readOnly.name)     -- Salida: nil

Cuando intentas establecer readOnly.name = "Alice", Lua ve que name no existe en la tabla. En lugar de añadirlo, Lua llama a la función __newindex con tres argumentos: la propia tabla, la clave que se está estableciendo y el valor que se está asignando.

En este ejemplo, la función simplemente imprime un mensaje y en realidad no almacena nada.

También puedes usar __newindex para validar datos antes de permitirlos en tu tabla:

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"  -- Salida: Health must be a number!
player.health = 100     -- Permitido

Observe el uso de rawset() en el segundo ejemplo. Esta función omite la metatabla y establece directamente el valor en la tabla.

Sin ello, establecer el valor activaría __newindex de nuevo, creando un bucle infinito.