List Tables

​

Syntax

r.tableList() → cursor
r.db(dbName).tableList() → cursor

​

Arguments

​

Optargs

​

Returns

​

Behavior

• Lists all tables in the specified database (or default database if not specified).
• Returns table names as strings in alphabetical order.
• If the database is empty (no tables), returns an empty array.

​

Notes & Caveats

• Table names are returned as strings, not table references.
• The order of table names is consistent (alphabetical).

​

Example

​

List tables in default database

const cursor = await r.tableList().run(client);
const tables = await cursor.toArray();

console.log('Tables in default database:', tables);
// Output: ['posts', 'users', 'comments']

​

List tables in specific database

const cursor = await r.db('ecommerce').tableList().run(client);

const tables = await cursor.toArray();
console.log('Tables in ecommerce database:', tables);

​

Related Functions

• r - Referencing the query builder
• db - Referencing a database
• dbList - Listing databases
• table - Referencing a table
• tableCreate - Creating a table
• tableDrop - Dropping a table