Skip to content
runtoolkit edited this page Apr 13, 2026 · 1 revision

Config

Global key-value config store with default value support.

Constructor

import { Config } from './src/config.js';

const config = new Config();

Usage

// Set a default — only takes effect if key not already set
config.setDefault('max_players', 20);

// Set a value explicitly
config.set('max_players', 50);

// Get — second argument is fallback if key doesn't exist
config.get('max_players');         // → 50
config.get('missing', 'default'); // → 'default'

config.has('max_players');         // → true
config.delete('max_players');      // remove key

// Reset to default value (or delete if no default was set)
config.reset('max_players');

config.clear(); // remove all entries (does not reset defaults)

Method chaining

set(), setDefault(), and merge() all return this.

config
  .setDefault('timeout', 5000)
  .setDefault('retries', 3)
  .set('timeout', 10000);

Bulk operations

// Merge an array of [key, value] pairs or Map entries
config.merge([['timeout', 5000], ['retries', 3]]);

// Enumerate all stored entries
config.entries();  // → [['key', value], ...]
config.list();     // → [{ key, value }, ...]

Clone this wiki locally