Additional utilities

Gurted includes several helpful utilities:

print(...)

We modify the global print() function to log to the browser console, and also convert any type (e.g. tables) to a readable string.

print('Hello, world!')
print({ name = 'Alice', age = 30, hobbies = {'reading', 'coding'} }) -- {age=30,hobbies={1="reading",2="coding"},name="Alice"}

table.tostring(table)

Converts a table to a readable string representation.

local data = { name = 'John', age = 30, hobbies = {'reading', 'coding'} }
local str = table.tostring(data) -- {age=30,hobbies={1="reading",2="coding"},name="John"}

string.replace(text, search, replacement)

Replaces the first occurrence of a string or regex pattern.

local text = 'Hello world, hello universe'
local result = string.replace(text, 'hello', 'hi')
trace.log(result)  -- Hello world, hi universe

local pattern = Regex.new('\\b\\w+@\\w+\\.\\w+\\b')
local masked = string.replace('Email: [email protected]', pattern, '[EMAIL]')
trace.log(masked)  -- Email: [EMAIL]

string.replaceAll(text, search, replacement)

Replaces all occurrences of a string or regex pattern.

local text = 'Hello world, hello universe'
local result = string.replaceAll(text, 'hello', 'hi')
trace.log(result) -- Hello world, hi universe

local pattern = Regex.new('\\b\\w+@\\w+\\.\\w+\\b')
local text = 'Emails: [email protected], [email protected]'
local masked = string.replaceAll(text, pattern, '[EMAIL]')
trace.log(masked) -- Emails: [EMAIL], [EMAIL]

string.trim(text)

Removes whitespace from the beginning and end of a string.

local messy = '   Hello World   '
local clean = string.trim(messy)
trace.log('"' .. clean .. '"')  -- "Hello World"

onNextFrame(callback)

Schedules a function to execute on the next frame render cycle. This helps sync your code with Godot's render pipeline, eliminating stuff like flickering.

local canvas = gurt.select("#my-canvas")
local ctx = canvas:withContext("2d")

onNextFrame(function()
    local x = math.random(0, canvas.width - 100)
    local y = math.random(0, canvas.height - 100)
    ctx:fillRect(x, y, 100, 100, "#ff0000")
end)