App

import { app } from '@mobrowser/api';

import { app } from '@mobrowser/api';

console.log(app.name)
console.log(app.version)

readonly packaged: boolean;

import { app } from '@mobrowser/api';

if (app.packaged) {
  console.log('Running in production')
}

readonly url: string;

import { app, BrowserWindow } from '@mobrowser/api';

const win = new BrowserWindow()
win.browser.loadUrl(app.url)

readonly name: string;

readonly version: string;

readonly description: string;

readonly copyright: string;

readonly schemes: string[];

readonly launchInfo: LaunchInfo;

import { app } from '@mobrowser/api';

if (app.launchInfo.isFirstRun) {
  console.log('Welcome!')
}

readonly windows: BrowserWindow[];

import { app, BrowserWindow } from '@mobrowser/api';

const win = new BrowserWindow()
win.setTitle('MyApp')
app.windows.forEach(win => console.log(win.title))

readonly theme: Theme;

import { app, BrowserWindow } from '@mobrowser/api';

const win = new BrowserWindow()
if (app.theme === 'dark') {
  win.setTitle('App (Dark Mode)')
}

readonly menu: Menu;

readonly trustedOrigins: string[];

"trustedOrigins": [ "https://foo.com", "*.foo.com", "https://*.foo.bar.com" ],

readonly loginItemSettings: LoginItemSettings;

import { app } from '@mobrowser/api';

if (app.loginItemSettings.openAtLogin) {
  console.log('Launch at login is enabled')
}

readonly permissions: AppPermissions;

import { app } from '@mobrowser/api';

const permission = 'microphone'
let status = app.permissions.getStatus(permission)

if (status === 'notDetermined') {
  await app.permissions.request(permission)
  status = app.permissions.getStatus(permission)
}

if (status === 'denied') {
  app.permissions.openSystemSettings(permission)
}

setMenu(menu: Menu): void;

import { app } from '@mobrowser/api';

app.setMenu(new Menu({
  items: [
    new MenuItem({
      id: 'quit',
      label: 'Quit',
      action: (item: MenuItem) => {
        app.quit()
      }
    })
  ]
}))

setTheme(theme: Theme): void;

import { app } from '@mobrowser/api';

// Set the dark theme
app.setTheme('dark')

// Set the light theme
app.setTheme('light')

// Set the theme of the operating system
app.setTheme('system')

showMessageDialog(options: MessageDialogOptions): Promise<MessageDialogResult>;

import { app, BrowserWindow } from '@mobrowser/api';

// Create a new window.
const win = new BrowserWindow()
win.setTitle('MyApp')
win.show()

// Show a message dialog.
const result = await app.showMessageDialog({
  parentWindow: win,
  title: 'Would you like to delete this conversation?',
  message: 'This conversation will be deleted from all of your devices. ' +
    'You cannot undo this action.',
  buttons: [
    { label: 'Cancel', type: 'secondary' },
    { label: 'Delete', type: 'primary' }
  ]
})

if (result.button.type === 'primary') {
  // The 'Delete' button was clicked.
}

showOpenDialog(options: OpenDialogOptions): Promise<OpenDialogResult>;

import { app, BrowserWindow } from '@mobrowser/api';

// Create a new window.
const win = new BrowserWindow()
win.setTitle('MyApp')
win.show()

// Show a file open dialog.
const result = await app.showOpenDialog({
 parentWindow: win,
 title: 'Open Files',
 defaultPath: '/Users/john/Desktop',
 selectionPolicy: 'files',
 features: {
   allowMultiple: true,
   canCreateDirectories: true
 },
})

if (!result.canceled) {
  console.log('Selected paths: ', result.paths[0])
}

showSaveDialog(options: SaveDialogOptions): Promise<SaveDialogResult>;

import { app, BrowserWindow } from '@mobrowser/api';

// Create a new window.
const win = new BrowserWindow()
win.setTitle('MyApp')
win.show()

// Show a file save dialog.
const result = await app.showSaveDialog({
  parentWindow: win,
  title: 'Save File',
  defaultPath: '/Users/john/Desktop',
  filters: [{ name: 'Text Files', extensions: ['txt'] }]
})

if (!result.canceled) {
  console.log('Selected path: ', result.path)
}

getPath(name: PathName): FilePath;

import { app } from '@mobrowser/api';

// Get the path to the app resources directory.
const dirPath = app.getPath('appResources')
console.log(dirPath)

quit(): void;

import { app, BrowserWindow } from '@mobrowser/api';

const win = new BrowserWindow()
win.show()
const result = await app.showMessageDialog({
  parentWindow: win,
  title: 'Quit',
  message: 'Are you sure you want to quit?',
  buttons: [
    { label: 'Cancel', type: 'secondary' },
    { label: 'Quit', type: 'primary' }
  ]
})
if (result.button.type === 'primary') {
  app.quit()
}

restart(): void;

import { app, BrowserWindow } from '@mobrowser/api';

const win = new BrowserWindow()
win.show()
const result = await app.showMessageDialog({
  parentWindow: win,
  title: 'Restart',
  message: 'Restart to apply the new settings?',
  buttons: [
    { label: 'Later', type: 'secondary' },
    { label: 'Restart', type: 'primary' }
  ]
})
if (result.button.type === 'primary') {
  app.restart()
}

setLoginItemSettings(settings: LoginItemSettings): void;

import { app } from '@mobrowser/api';

app.setLoginItemSettings({
  openAtLogin: true,
  args: ['--hidden'], // Windows only
})

checkForUpdate(source: string): Promise<AppUpdate | undefined | string>;

import { app, AppUpdate } from '@mobrowser/api';

const result = await app.checkForUpdate('https://app.com/updates')
if (!result) {
  // No update is available or do nothing.
} else if (typeof result === 'string') {
  // An error occurred while checking for updates.
} else {
  // An update is available.
  const appUpdate: AppUpdate = result
  console.log('Update available: ', appUpdate.version)
}

on(event: 'activated', listener: () => void): void;
off(event: 'activated', listener: () => void): void;

import { app, BrowserWindow } from '@mobrowser/api';

app.on('activated', () => {
  if (app.windows.length === 0) {
    const win = new BrowserWindow({
      size: { width: 800, height: 650 },
    })
    win.browser.loadUrl(app.url)
    win.show()
  }
})

on(event: 'allWindowsClosed', listener: () => void): void;
off(event: 'allWindowsClosed', listener: () => void): void;

import { app } from '@mobrowser/api';

app.on('allWindowsClosed', () => {
  // On macOS it is common for applications to stay open
  // until the user explicitly quits.
  if (process.platform !== 'darwin') {
    app.quit()
  }
})

handle(action: 'openUrl', handler: (url: string, queryParams: Record<string, string>) => void): void;
removeHandler(action: 'openUrl'): void;

myapp://open?file=123&mode=edit

import { app } from '@mobrowser/api';

app.handle('openUrl', (url: string, queryParams: Record<string, string>) => {
  console.log('URL:', url, queryParams)
})