Back to Qt.io
Contact Us Blog Download Qt

WebEngineProfilePrototype QML Type

QQuickWebEngineProfile 클래스의 인스턴스를 생성합니다. 더 보기...

Import Statement: import QtWebEngine
Since: QtWebEngine 6.9

속성

상세 설명

WebEngineProfile 프로필에 속한 모든 보기에서 공유하는 설정, 스크립트 및 방문한 링크 목록이 포함되어 있습니다. 프로필의 일부 속성은 한 번의 호출로 초기화해야 하며 프로필 수명 기간 동안 수정해서는 안 됩니다. 웹엔진프로필프로토타입은 필요한 모든 속성이 설정된 상태에서 프로필을 만드는 방법을 제공합니다.

// 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 캐시가 저장되는 위치의 경로입니다.

기본적으로 캐시는 QStandardPaths::writableLocation(QStandardPaths::CacheLocation) 아래에 storageName 을 사용하여 명명된 디렉터리에 저장됩니다.


httpCacheMaximumSize : int

HTTP 캐시의 최대 크기입니다. 0 인 경우 QtWebEngine 에 의해 크기가 자동으로 제어됩니다. 기본값은 0 입니다.

WebEngineProfilePrototype::httpCacheType도 참조하세요 .


httpCacheType : enumeration

이 열거형은 HTTP 캐시의 유형을 설명합니다:

Constant설명
WebEngineProfile.MemoryHttpCache인메모리 캐시를 사용합니다. 기본값인 storageName 이 설정되어 있지 않거나 오프더레코드가 설정되어 있지 않은 경우에만 사용할 수 있는 설정입니다.
WebEngineProfile.DiskHttpCache디스크 캐시를 사용합니다. 오프더레코드가 아닌 프로필의 기본값은 storageName 입니다.
WebEngineProfile.NoCache캐시를 비활성화합니다.

persistentCookiesPolicy : enumeration

이 열거형은 쿠키 지속성 정책을 설명합니다:

Constant설명
WebEngineProfile.NoPersistentCookies세션 쿠키와 영구 쿠키 모두 메모리에 저장됩니다. 이 설정은 오프더레코드가 설정되어 있거나 기본값인 storageName 을 사용할 수 없는 경우에만 가능합니다.
WebEngineProfile.AllowPersistentCookies영구로 표시된 쿠키는 디스크에 저장되고 디스크에서 복원되는 반면, 세션 쿠키는 충돌 복구를 위해서만 디스크에 저장됩니다. 이 값은 storageName 을 사용하는 비기록 프로필의 기본값입니다.
WebEngineProfile.ForcePersistentCookies세션 쿠키와 영구 쿠키 모두 디스크에 저장되고 디스크에서 복원됩니다.

persistentPermissionsPolicy : enumeration

이 열거형은 권한 지속성에 대한 정책을 설명합니다:

상수설명
WebEngineProfile.AskEveryTime애플리케이션은 이전에 권한을 부여했는지 여부에 관계없이 권한이 필요할 때마다 권한을 요청합니다. 이는 기존 애플리케이션과의 이전 버전과의 호환성을 위한 것이며, 그렇지 않은 경우에는 권장되지 않습니다.
WebEngineProfile.StoreInMemory권한이 처음 필요할 때만 요청이 이루어집니다. 이후의 모든 요청은 최초 사용자 선택에 따라 자동으로 승인 또는 거부됩니다. 이는 애플리케이션이 종료될 때까지 동일한 QWebEngineProfile 인스턴스를 사용하는 모든 페이지에 적용됩니다. off-the-record 이 설정되어 있거나 영구 데이터 경로를 사용할 수 없는 경우 적용되는 설정입니다.
WebEngineProfile.StoreOnDiskPersistentPermissionsInMemory 과 동일한 방식으로 작동하지만 권한이 디스크에 저장되고 디스크에서 복원됩니다. 기본 설정입니다.

persistentStoragePath : string

브라우저 및 웹 콘텐츠에 대한 영구 데이터가 저장되는 위치의 경로입니다. 영구 데이터에는 영구 쿠키, HTML5 로컬 저장소 및 방문한 링크가 포함됩니다.

기본적으로 저장소는 QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) 아래의 storageName 이라는 이름의 디렉토리에 있습니다.


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.