Мини-приложения

JAVASCRIPT

const SETTINGS_KEY = 'app-settings';
async function loadSettings() {
  try {
    const { value } = await LcPanel.storage.get(SETTINGS_KEY);
    return value || getDefaultSettings();
  } catch {
    return getDefaultSettings();
  }
}
async function saveSettings(settings) {
  await LcPanel.storage.put(SETTINGS_KEY, settings);
  LcPanel.notify({ level: 'success', message: 'Настройки сохранены' });
}

Ограничения хранилища

• Ключ - непустая строка;
• Значение сериализуется на сервере (JSON);
• Данные доступны только внутри панели;
• При ошибке API Promise отклоняется с текстом ошибки.

Типичные проблемы

JAVASCRIPT

const parentOrigin = new URLSearchParams(location.search).get('parent_origin');
LcPanel.init({ clientId, parentOrigin });

2. Вызывайте ready() после загрузки UI

JAVASCRIPT

async function bootstrap() {
  LcPanel.init({ clientId, parentOrigin });
const context = await LcPanel.getContext();
  renderApp(context);
LcPanel.ready();
}

3. Реагируйте на смену темы

JAVASCRIPT

LcPanel.on('THEME_CHANGED', ({ theme }) => {
  document.documentElement.dataset.theme = theme;
});

4. Не храните секреты в хранилище. Оно предназначено для пользовательских настроек и состояния UI, не для секретов и токенов.

5. Обрабатывайте ошибки

JAVASCRIPT

async function safeGet(key, fallback = null) {
  try {
    const { value } = await LcPanel.storage.get(key);
    return value ?? fallback;
  } catch {
    return fallback;
  }
}

JAVASCRIPT

// Инициализация
LcPanel.init({ clientId, parentOrigin });
LcPanel.ready();
// Контекст
const ctx = await LcPanel.getContext();
// Уведомления
LcPanel.notify({ level: 'success', message: 'Готово' });
// OAuth
LcPanel.requestOAuth({ scopes: ['id.read'] });
// Storage
await LcPanel.storage.put('key', { foo: 'bar' });
const { value } = await LcPanel.storage.get('key');
await LcPanel.storage.remove('key');
// События
LcPanel.on('THEME_CHANGED', (p) => console.log(p.theme));
// Закрытие
LcPanel.close();
// Очистка
LcPanel.destroy();