El metamétodo __newindex

Has aprendido cómo __index controla lo que ocurre cuando intentas leer una clave que no existe en una tabla. Ahora descubrirás su contraparte: __newindex, que controla lo que ocurre cuando asignas un valor a una clave que la tabla todavía no tiene.

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 permite interceptar y controlar las modificaciones antes de que se realicen.

Aquí tienes un ejemplo sencillo que impide que se añadan claves nuevas 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 tabla misma, 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 los datos antes de permitir que se añadan a 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, almacenado con rawset
player.health = "high"  -- Sin mensaje: health ya existe

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

Sin él, establecer el valor volvería a activar __newindex, creando un bucle infinito.

Como __newindex solo se ejecuta para las claves que la tabla no tiene, esta comprobación protege la primera asignación de cada clave. Una vez que rawset ha almacenado health, las asignaciones posteriores la cambian directamente. Para comprobar cada asignación, mantén vacía la tabla y almacena los valores en una segunda tabla, a la que accede mediante __index:

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

player.health = 100
player.health = "high"  -- Salida: Health must be a number!
print(player.health)    -- Salida: 100

player nunca obtiene una clave propia, así que cada asignación pasa por __newindex, y cada lectura recurre a __index para acceder a data.