onDebugMessage

Disparado para toda mensagem que a camada de script manda para a saída de debug: outputDebugString, erros de execução de script e as reclamações de argumento inválido que as funções levantam. Mensagens que o próprio servidor registra — rede, resources, licença — não contam.

Origem

A raiz do servidor.

Parâmetros

Posição	Nome	Tipo	Descrição
1	mensagem	string	O texto da mensagem.
2	nivel	int	1 erro, 2 aviso, 3 informação.
3	arquivo	string	O arquivo de script de onde a mensagem veio, ou nil quando não se sabe.
4	linha	int	A linha nesse arquivo, ou nil.

Cancelável

Não.

A origem viaja ao lado da mensagem, nunca dentro dela, então mensagem é exatamente o que foi escrito. Este é o par do onClientDebugMessage, que carrega a origem embutida no texto.

-- manda os erros para um arquivo de log
addEventHandler("onDebugMessage", root, function(mensagem, nivel, arquivo, linha)
    if nivel ~= 1 then return end
    local handle = fileOpen("errors.log") or fileCreate("errors.log")
    fileSetPos(handle, fileGetSize(handle))
    fileWrite(handle, (arquivo or "?") .. ":" .. (linha or 0) .. "  " .. mensagem .. "\n")
    fileClose(handle)
end)

Nota

Um outputDebugString dentro deste manipulador não dispara o evento de novo — a reentrada é bloqueada de propósito, então não existe laço infinito. A mensagem continua chegando no log, ela só não passa pelo evento.

Veja também

• onShutdown — Disparado quando o servidor está caindo, antes de os resources serem parados.