koala73/worldmonitor · error · Error

Unsupported settings version: ${parsed.version}

Error message

Unsupported settings version: ${parsed.version}

What it means

UI error in importSettings: the export file's version field is not 1, the only currently supported settings format. A forward/backward-compatibility guard — future or hand-edited versions are rejected before any migration is attempted.

Source

Thrown at src/utils/settings-persistence.ts:92

  return new Promise((resolve, reject) => {
    if (file.size > MAX_IMPORT_SIZE_BYTES) {
      reject(new Error('File is too large. Maximum size is 5MB.'));
      return;
    }

    const reader = new FileReader();

    reader.onload = (e) => {
      try {
        const result = e.target?.result as string;
        const parsed = JSON.parse(result) as ExportedSettings;

        if (!parsed || typeof parsed.data !== 'object' || Array.isArray(parsed.data)) {
          throw new Error('Invalid format: expected an object with a data property.');
        }

        if (parsed.version !== 1) {
          throw new Error(`Unsupported settings version: ${parsed.version}`);
        }

        let keysImported = 0;
        const importedKeys: string[] = [];
        for (const [key, value] of Object.entries(parsed.data)) {
          if (isSettingsKey(key) && typeof value === 'string') {
            localStorage.setItem(key, value);
            keysImported++;
            importedKeys.push(key);
          }
        }
        invalidatePanelStorageCacheForKeys(importedKeys);

        resolve({ success: true, keysImported });
      } catch (err) {
        reject(err);
      }
    };

View on GitHub (pinned to a96956387a)

Solutions

1. Re-export settings from a compatible app version
2. Do not hand-edit the version field of the export file

When it happens

Trigger: Thrown at src/utils/settings-persistence.ts:89 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of koala73/worldmonitor@a96956387a (2026-08-21). Data as JSON: /api/errors/b8f01fdad9802a7e. Report an issue: GitHub.