Back to Qt.io
Contact Us Blog Download Qt

WebEngineProfilePrototype QML Type

QQuickWebEngineProfile クラスのインスタンスを作成します。詳細...

Import Statement: import QtWebEngine
Since: QtWebEngine 6.9

プロパティ

詳細説明

WebEngineProfile には、設定、スクリプト、およびプロファイルに属するすべてのビューで共有される訪問済みリンクのリストが含まれます。プロファイルのプロパティの一部は、1 回の呼び出しで初期化する必要があり、プロファイルの有効期間中は変更できません。WebEngineProfilePrototype は、必要なプロパティがすべて設定されている場合に、プロファイルを作成する方法を提供します。

// creating OTR profile
WebEngineProfilePrototype: {
    id: otrProfile
}
let otrProfile = otrProfile.instance();

// creating non-OTR profile
WebEngineProfilePrototype: {
    id: nonOtrProfile
    storageName: 'Test'
}
let profile = nonOtrProfile.instance();

プロパティの説明

cachePath : string

プロファイルのキャッシュ、特に HTTP キャッシュが保存される場所へのパス。

デフォルトでは、キャッシュはstorageName を使用して命名されたディレクトリのQStandardPaths::writableLocation(QStandardPaths::CacheLocation) の下に保存されます。


httpCacheMaximumSize : int

HTTP キャッシュの最大サイズ。0 の場合、サイズはQtWebEngine によって自動的に制御されます。デフォルト値は0 です。

WebEngineProfilePrototype::httpCacheTypeも参照してください。


httpCacheType : enumeration

この列挙は、HTTP キャッシュのタイプを記述します：

定数説明
WebEngineProfile.MemoryHttpCacheメモリ内キャッシュを使用します。これは、offTheRecord が設定されているか、storageName がない場合にのみ可能な設定で、デフォルトです。
WebEngineProfile.DiskHttpCacheディスク・キャッシュを使用します。これは off-the-record プロファイルでないstorageName のデフォルト値です。
WebEngineProfile.NoCacheキャッシュを無効にします。

persistentCookiesPolicy : enumeration

この列挙は、クッキーの永続性のポリシーを記述します：

定数説明
WebEngineProfile.NoPersistentCookiesセッション・クッキーと永続的クッキーの両方がメモリに保存されます。これは offTheRecord が設定されているか、storageName が利用できない場合にのみ可能な設定で、デフォルトはこれです。
WebEngineProfile.AllowPersistentCookies永続的とマークされたクッキーはディスクに保存され、ディスクからリストアされますが、セッション・クッキーはクラッシュ回復のためにのみディスクに保存されます。これはstorageName を持つ非 off-the-record プロファイルのデフォルト値です。
WebEngineProfile.ForcePersistentCookiesセッション・クッキーと永続的クッキーの両方がディスクに保存され、ディスクから復元されます。

persistentPermissionsPolicy : enumeration

この列挙はパーミッションの永続性のためのポリシーを記述します：

定数説明
WebEngineProfile.AskEveryTimeこの列挙はパーミッションの永続性に関するポリシーを記述します。これは既存のアプリケーションとの後方互換性のためであり、それ以外は推奨されません。
WebEngineProfile.StoreInMemoryリクエストが行われるのは、パーミッションが初めて必要になったときだけです。それ以降のリクエストは、最初のユーザーの選択に応じて、自動的に許可または拒否されます。これは、アプリケーションがシャットダウンされるまで、同じQWebEngineProfile インスタンスを使用しているすべてのページに引き継がれます。これは、off-the-record が設定されているか、永続データパスが利用できない場合に適用される設定です。
WebEngineProfile.StoreOnDiskPersistentPermissionsInMemory と同じように動作しますが、パーミッションはディスクに保存され、ディスクから復元されます。これはデフォルトの設定です。

persistentStoragePath : string

ブラウザと Web コンテンツの永続データが保存される場所へのパス。永続データには、永続クッキー、HTML5 ローカルストレージ、訪問済みリンクが含まれます。

デフォルトでは、ストレージはstorageName を使用して命名されたディレクトリ内のQStandardPaths::writableLocation(QStandardPaths::AppDataLocation) の下に配置されます。


storageName : string

このストレージ名は、永続データとキャッシュの保存にディスクを使用するプロファイルごとに個別のサブディレクトリを作成するために使用されます。ストレージ名は一意でなければならない。

WebEngineProfilePrototype::persistentStoragePath およびWebEngineProfilePrototype::cachePathも参照 。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.