本文へスキップ

BrowserWindowConstructorOptions オブジェクトは `BaseWindowConstructorOptions` を拡張

  • webPreferences WebPreferences (オプション) - ウェブページの機能の設定。
    • devTools boolean (オプション) - DevTools を有効にするかどうか。false に設定されている場合、BrowserWindow.webContents.openDevTools() を使用して DevTools を開くことはできません。デフォルトは true です。
    • nodeIntegration boolean (オプション) - Node 統合が有効かどうか。デフォルトは false です。
    • nodeIntegrationInWorker boolean (オプション) - Web ワーカーで Node 統合が有効かどうか。デフォルトは false です。詳細については マルチスレッド化 を参照してください。
    • nodeIntegrationInSubFrames boolean (オプション) - iframe や子ウィンドウなどのサブフレームで Node.js のサポートを有効にする実験的なオプションです。すべてのプリロードは各 iframe に対してロードされます。process.isMainFrame を使用して、メインフレーム内にあるかどうかを判断できます。
    • preload string (オプション) - ページで他のスクリプトが実行される前にロードされるスクリプトを指定します。このスクリプトは、Node 統合がオンでもオフでも、常に Node API にアクセスできます。値はスクリプトへの絶対ファイルパスである必要があります。Node 統合がオフの場合、プリロードスクリプトは Node のグローバルシンボルをグローバルスコープに再導入できます。例については こちら を参照してください。
    • sandbox boolean (オプション) - 設定されている場合、ウィンドウに関連付けられたレンダラーをサンドボックス化し、Chromium OS レベルのサンドボックスと互換性を持たせ、Node.js エンジンを無効にします。これは nodeIntegration オプションとは異なり、プリロードスクリプトで使用できる API はより制限されています。このオプションの詳細については こちら を参照してください。
    • session Session (オプション) - ページで使用されるセッションを設定します。Session オブジェクトを直接渡す代わりに、代わりに `partition` オプションを使用することもできます。これはパーティション文字列を受け入れます。sessionpartition の両方が提供されている場合、session が優先されます。デフォルトはデフォルトセッションです。
    • partition string (オプション) - セッションのパーティション文字列に従って、ページで使用されるセッションを設定します。partition が `persist:` で始まる場合、ページは、同じ `partition` を持つアプリ内のすべてのページで使用可能な永続セッションを使用します。`persist:` プレフィックスがない場合、ページはインメモリセッションを使用します。同じ `partition` を割り当てることで、複数のページが同じセッションを共有できます。デフォルトはデフォルトセッションです。
    • zoomFactor number (オプション) - ページのデフォルトのズーム係数。3.0300% を表します。デフォルトは 1.0 です。
    • javascript boolean (オプション) - JavaScript のサポートを有効にします。デフォルトは true です。
    • webSecurity boolean (オプション) - false の場合、同一オリジンポリシーを無効にし(通常はユーザーによるテストウェブサイトの使用)、このオプションがユーザーによって設定されていない場合は allowRunningInsecureContenttrue に設定します。デフォルトは true です。
    • allowRunningInsecureContent boolean (オプション) - https ページが http URL から JavaScript、CSS、またはプラグインを実行することを許可します。デフォルトは false です。
    • images boolean (オプション) - 画像のサポートを有効にします。デフォルトは true です。
    • imageAnimationPolicy string (オプション) - 画像アニメーション(例:GIF)を実行する方法を指定します。animateanimateOnce、または noAnimation のいずれかになります。デフォルトは animate です。
    • textAreasAreResizable boolean (オプション) - テキストエリア要素をサイズ変更可能にします。デフォルトは true です。
    • webgl boolean (オプション) - WebGL のサポートを有効にします。デフォルトは true です。
    • plugins boolean (オプション) - プラグインを有効にするかどうか。デフォルトは false です。
    • experimentalFeatures boolean (オプション) - Chromium の実験的な機能を有効にします。デフォルトは false です。
    • scrollBounce boolean (オプション) macOS - macOS でスクロールバウンス(ラバーバンディング)効果を有効にします。デフォルトは false です。
    • enableBlinkFeatures string (オプション) - 有効にする機能文字列のリストをカンマで区切って指定します(例:CSSVariables,KeyboardEventKey)。サポートされている機能文字列の完全なリストは、RuntimeEnabledFeatures.json5 ファイルにあります。
    • disableBlinkFeatures string (オプション) - 無効にする機能文字列のリストをカンマで区切って指定します(例:CSSVariables,KeyboardEventKey)。サポートされている機能文字列の完全なリストは、RuntimeEnabledFeatures.json5 ファイルにあります。
    • defaultFontFamily Object (オプション) - フォントファミリーのデフォルトフォントを設定します。
      • standard string (オプション) - デフォルトは Times New Roman です。
      • serif string (オプション) - デフォルトは Times New Roman です。
      • sansSerif string (オプション) - デフォルトは Arial です。
      • monospace string (オプション) - デフォルトは Courier New です。
      • cursive string (オプション) - デフォルトは Script です。
      • fantasy string (オプション) - デフォルトは Impact です。
      • math string (オプション) - デフォルトは Latin Modern Math です。
    • defaultFontSize Integer (オプション) - デフォルトは 16 です。
    • defaultMonospaceFontSize Integer (オプション) - デフォルトは 13 です。
    • minimumFontSize Integer (オプション) - デフォルトは 0 です。
    • defaultEncoding string (オプション) - デフォルトは ISO-8859-1 です。
    • backgroundThrottling boolean (オプション) - ページがバックグラウンドになったときに、アニメーションとタイマーを調整するかどうか。これにより、ページの可視性 API も影響を受けます。単一の browserWindow に表示されている少なくとも 1 つの webContentsbackgroundThrottling が無効になっている場合、フレームはウィンドウ全体とそこに表示されている他の webContents に対して描画され、スワップされます。デフォルトは true です。
    • offscreen boolean (オプション) - ブラウザウィンドウのオフスクリーンレンダリングを有効にするかどうか。デフォルトは false です。オフスクリーンレンダリングのチュートリアル を参照して詳細を確認してください。
    • contextIsolation boolean (オプション) - Electron API と指定された preload スクリプトを個別の JavaScript コンテキストで実行するかどうか。デフォルトは true です。preload スクリプトが実行されるコンテキストには、独自の専用 documentwindow グローバル、および独自の JavaScript ビルトイン(ArrayObjectJSON など)のみアクセスでき、それらはロードされたコンテンツに対しては非表示です。Electron API は preload スクリプトでのみ使用可能になり、ロードされたページでは使用できません。このオプションは、ロードされたコンテンツが preload スクリプトと使用されている Electron API を改ざんできないようにするために、潜在的に信頼できないリモートコンテンツをロードする場合に使用してください。このオプションは、Chrome コンテンツスクリプト で使用されているのと同じ手法を使用します。コンソールタブの上部にあるコンボボックスで「Electron Isolated Context」エントリを選択することで、デベロッパーツールでこのコンテキストにアクセスできます。
    • webviewTag boolean (オプション) - <webview> タグ を有効にするかどうか。デフォルトは false です。注記:<webview> に対して設定された preload スクリプトは、実行時に Node 統合が有効になります。そのため、リモート/信頼できないコンテンツが、悪意のある可能性のある preload スクリプトを使用して <webview> タグを作成できないことを確認する必要があります。webContentswill-attach-webview イベントを使用して、preload スクリプトを取り除き、<webview> の初期設定を検証または変更できます。
    • additionalArguments string[] (オプション) - アプリのレンダラープロセスで process.argv に追加される文字列のリストです。レンダラープロセスのプリロードスクリプトに少量のデータを渡すのに役立ちます。
    • safeDialogs boolean (オプション) - ブラウザスタイルの連続ダイアログ保護を有効にするかどうか。デフォルトは false です。
    • safeDialogsMessage 文字列(オプション) - 連続ダイアログ保護がトリガーされたときに表示するメッセージ。定義されていない場合、デフォルトメッセージが使用されます。現在のデフォルトメッセージは英語であり、ローカライズされていないことに注意してください。
    • disableDialogs ブール値(オプション) - ダイアログを完全に無効にするかどうか。safeDialogs をオーバーライドします。デフォルトは false です。
    • navigateOnDragDrop ブール値(オプション) - ファイルまたはリンクをページにドラッグアンドドロップすると、ナビゲーションが発生するかどうか。デフォルトは false です。
    • autoplayPolicy 文字列(オプション) - ウィンドウ内のコンテンツに適用する自動再生ポリシー。no-user-gesture-requireduser-gesture-requireddocument-user-activation-required のいずれかになります。デフォルトは no-user-gesture-required です。
    • disableHtmlFullscreenWindowResize ブール値(オプション) - HTMLフルスクリーンへの移行時にウィンドウのサイズ変更を防止するかどうか。デフォルトは false です。
    • accessibleTitle 文字列(オプション) - スクリーンリーダーなどのアクセシビリティツールにのみ提供される代替タイトル文字列。この文字列はユーザーには直接表示されません。
    • spellcheck ブール値(オプション) - 組み込みのスペルチェッカーを有効にするかどうか。デフォルトは true です。
    • enableWebSQL ブール値(オプション) - WebSQL API を有効にするかどうか。デフォルトは true です。
    • v8CacheOptions 文字列(オプション) - blink が使用する v8 コードキャッシングポリシーを強制します。有効な値は次のとおりです。
      • none - コードキャッシングを無効にします。
      • code - ヒューリスティックベースのコードキャッシング。
      • bypassHeatCheck - コードキャッシングのヒューリスティックをバイパスしますが、遅延コンパイルを行います。
      • bypassHeatCheckAndEagerCompile - 上記と同じですが、コンパイルは早期に行われます。デフォルトポリシーは code です。
    • enablePreferredSizeMode ブール値(オプション) - 推奨サイズモードを有効にするかどうか。推奨サイズは、スクロールを必要とせずにドキュメントのレイアウトを収容するために必要な最小サイズです。これを有効にすると、推奨サイズが変更されたときに WebContentspreferred-size-changed イベントが発生します。デフォルトは false です。
    • transparent ブール値(オプション) - ゲストページの背景の透過性を有効にするかどうか。デフォルトは true です。**注:** ゲストページのテキストと背景の色は、ルート要素のカラースキームから取得されます。透過性が有効な場合、テキストの色はそれに応じて変更されますが、背景は透過状態のままです。
  • paintWhenInitiallyHidden ブール値(オプション) - showfalse で、作成されたばかりの場合にレンダラーをアクティブにするかどうか。show: false での初回ロード時に document.visibilityState を正しく動作させるには、これを false に設定する必要があります。これを false に設定すると、ready-to-show イベントは発生しなくなります。デフォルトは true です。