A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
import { getPlatform } from '../platform/base';
import { log } from './logger';
const KEY_PREFIX = 'esengine:';
export const Storage = {
/** Await the host's pending writes; without this capability, no cloud acknowledgment is implied. */
async flush(): Promise<void> {
const platform = getPlatform();
await platform.flushStorage?.();
},
getString(key: string, defaultValue?: string): string | undefined {
const raw = getPlatform().getStorageItem(KEY_PREFIX + key);
return raw !== null ? raw : defaultValue;
},
setString(key: string, value: string): void {
getPlatform().setStorageItem(KEY_PREFIX + key, value);
},
getNumber(key: string, defaultValue?: number): number | undefined {
const raw = getPlatform().getStorageItem(KEY_PREFIX + key);
if (raw === null) return defaultValue;
const num = Number(raw);
return Number.isNaN(num) ? defaultValue : num;
},
setNumber(key: string, value: number): void {
getPlatform().setStorageItem(KEY_PREFIX + key, String(value));
},
getBoolean(key: string, defaultValue?: boolean): boolean | undefined {
const raw = getPlatform().getStorageItem(KEY_PREFIX + key);
if (raw === null) return defaultValue;
return raw === 'true';
},
setBoolean(key: string, value: boolean): void {
getPlatform().setStorageItem(KEY_PREFIX + key, String(value));
},
getJSON<T>(key: string, defaultValue?: T): T | undefined {
const raw = getPlatform().getStorageItem(KEY_PREFIX + key);
if (raw === null) return defaultValue;
try {
return JSON.parse(raw) as T;
} catch (e) {
log.warn('storage', `Failed to parse JSON for key "${key}"`, e);
return defaultValue;
}
},
setJSON<T>(key: string, value: T): void {
getPlatform().setStorageItem(KEY_PREFIX + key, JSON.stringify(value));
},
remove(key: string): void {
getPlatform().removeStorageItem(KEY_PREFIX + key);
},
has(key: string): boolean {
return getPlatform().getStorageItem(KEY_PREFIX + key) !== null;
},
clear(): void {
getPlatform().clearStorage(KEY_PREFIX);
},
};