Skip to content

db

This content is for v0.2.1. Switch to the latest version for up-to-date documentation.

The db namespace provides lightweight, zero-configuration embedded relational database capabilities using SQLite.


FunctionSignatureReturn TypeDescription
db.opendb.open(path)databaseOpens or creates an embedded database file.
database.execdatabase.exec(sql)voidExecutes a DDL or modification statement.
database.querydatabase.query(sql, params)arrayRuns a query and returns matched rows as an array of objects.
database.closedatabase.close()voidCloses the database connection.

var conn = db.open("app.db");
conn.exec("CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT, score INTEGER);");
conn.exec("INSERT INTO users (name, score) VALUES ('Alice', 120);");
conn.exec("INSERT INTO users (name, score) VALUES ('Bob', 95);");
var rows = conn.query("SELECT * FROM users WHERE score > ? ORDER BY score DESC;", [100]);
var i = 0;
while (i < len(rows)) {
var user = rows[i];
print("User: " + user["name"] + " — Score: " + str(user["score"]));
i = i + 1;
}
conn.close();