Back to Qt.io
Contact Us Blog Download Qt

WebEngineProfile QML Type

여러 웹 엔진 보기에 공통으로 적용되는 설정, 스크립트 및 방문한 링크가 포함되어 있습니다. 더 보기...

Import Statement: import QtWebEngine
Since: QtWebEngine 1.1
In C++: QQuickWebEngineProfile

속성

신호

방법

자세한 설명

웹엔진프로필에는 프로필에 속한 모든 보기에서 공유하는 설정, 스크립트 및 방문한 링크 목록이 포함되어 있습니다.

방문한 링크에 대한 정보는 영구 쿠키 및 기타 영구 데이터와 함께 storageName 속성에 의해 결정되는 저장소에 저장됩니다. 영구 데이터는 persistentStoragePath 속성에 의해 결정되는 하위 디렉터리에 저장되고 캐시는 cachePath 속성에 의해 결정되는 하위 디렉터리에 저장됩니다. httpCacheType 속성은 캐시 유형( 인메모리 또는 온디스크)을 설명합니다. storageName 속성만 설정하면 다른 값은 이 속성을 기준으로 자동으로 생성됩니다. 값을 수동으로 지정하는 경우 프로필에 속하는 페이지를 만들기 전에 지정해야 합니다.

프로필을 사용하여 페이지를 서로 격리할 수 있습니다. 일반적인 사용 사례는 비공개 브라우징 모드를 위한 전용 오프더레코드 프로필입니다. 비공개 프로필은 쿠키, HTTP 캐시 및 기타 일반적으로 영구적인 데이터를 메모리에만 저장하도록 강제합니다. offTheRecord 속성은 프로필이 오프 더 레코드인지 여부를 나타냅니다.

각 웹 엔진 보기에는 연결된 프로필이 있습니다. 특정 프로필이 설정되어 있지 않은 뷰는 기본적으로 오프더레코드인 공통 프로필을 공유합니다.

속성 문서

cachePath : string

프로필의 캐시, 특히 HTTP 캐시가 저장되는 위치의 경로입니다.

기본적으로 캐시는 QStandardPaths::writableLocation(QStandardPaths::CacheLocation) 아래에 storageName 이라는 이름의 디렉터리에 저장됩니다.


downloadPath : string [since QtWebEngine 1.9]

다운로드한 파일이 저장되는 위치의 경로입니다.

다운로드 위치에 사용되는 기본 경로를 재정의합니다.

빈 문자열로 설정하면 기본 경로가 복원됩니다.

참고: 기본적으로 다운로드 경로는 QStandardPaths::DownloadLocation 입니다.

이 속성은 QtWebEngine 1.9에 도입되었습니다.


httpAcceptLanguage : string [since QtWebEngine 1.2]

Accept-Language HTTP 요청 헤더 필드의 값입니다.

이 속성은 QtWebEngine 1.2에 도입되었습니다.


httpCacheMaximumSize : int

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

httpCacheType 를참조하십시오 .


httpCacheType : enumeration

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

Constant설명
WebEngineProfile.MemoryHttpCache인메모리 캐시를 사용합니다. offTheRecord 가 설정되어 있거나 기본값인 storageName 을 사용할 수 없는 경우에만 가능한 설정입니다.
WebEngineProfile.DiskHttpCache디스크 캐시를 사용합니다. storageName 이 설정된 비기록 프로필의 기본값입니다.
WebEngineProfile.NoCache캐시를 비활성화합니다. (5.7에 추가됨)

httpUserAgent : string

브라우저를 식별하기 위해 HTTP와 함께 전송되는 사용자 에이전트 문자열입니다.

참고: Windows 8.1 이상에서는 애플리케이션에 최신 Windows 버전을 지원되는 것으로 선언하는 매니페스트가 포함되어 있지 않는 한 기본 사용자 에이전트는 항상 "Windows NT 6.2"(Windows 8)를 보고합니다.


isPushServiceEnabled : bool [since QtWebEngine 6.5]

푸시 메시징 서비스가 사용 설정되어 있는지 여부.

참고: 기본적으로 푸시 메시징 서비스는 비활성화되어 있습니다.

참고: Qt WebEngine 은 브라우저 푸시 서비스로 Firebase 클라우드 메시징(FCM) 을 사용합니다. 따라서 모든 푸시 메시지는 Google 푸시 서비스와 해당 서버를 거치게 됩니다.

이 속성은 QtWebEngine 6.5에 도입되었습니다.


offTheRecord : bool

웹 엔진 프로필이 오프더레코드인지 여부. 오프 더 레코드 프로파일은 쿠키, HTTP 캐시 및 기타 일반적으로 영구적인 데이터를 메모리에만 저장하도록 합니다. 프로필은 기본적으로 비공개입니다.

프로필을 오프더레코드에서 디스크 기반 동작으로 변경하려면 적절한 storageName 을 설정해야 합니다.

storageName도 참조하세요 .


persistentCookiesPolicy : enumeration

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

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

persistentPermissionsPolicy : enumeration [since 6.8]

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

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

이 속성은 Qt 6.8에 도입되었습니다.


persistentStoragePath : string

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

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


spellCheckEnabled : bool [since QtWebEngine 1.4]

이 속성은 웹 엔진 맞춤법 검사기 활성화 여부를 보유합니다.

이 프로퍼티는 QtWebEngine 1.4에 도입되었습니다.


spellCheckLanguages : list<string> [since QtWebEngine 1.4]

이 속성은 맞춤법 검사기에서 사용하는 언어 목록을 보유합니다. 각 언어는 .bdic 사전의 이름과 일치해야 합니다. 예를 들어 en-US 언어는 en-US.bdic 사전 파일을 로드합니다.

사전 파일을 검색하는 방법은 맞춤법 검사기 기능 설명서를 참조하세요.

.bdic 사전을 컴파일하는 방법에 대한 자세한 내용은 맞춤법 검사기 예제를 참조하세요.

이 프로퍼티는 QtWebEngine 1.4에 도입되었습니다.


storageName : string

영구 데이터 및 캐시를 저장하기 위해 디스크를 사용하는 각 프로필에 대해 별도의 하위 디렉터리를 만드는 데 사용되는 저장소 이름입니다.

WebEngineProfile::persistentStoragePath 및 WebEngineProfile::cachePath 을참조하십시오 .


userScripts : WebEngineScriptCollection [read-only]

이 프로파일을 공유하는 모든 페이지에 삽입된 WebEngineScript 객체 컬렉션을 반환합니다.


신호 문서

[since QtWebEngine 6.7] clearHttpCacheCompleted()

이 신호는 clearHttpCache() 작업이 완료되면 전송됩니다.

참고: 해당 핸들러는 onClearHttpCacheCompleted 입니다.

이 신호는 QtWebEngine 6.7에 도입되었습니다.

clearHttpCache()도 참조하십시오 .


downloadFinished(WebEngineDownloadRequest download)

이 신호는 다운로드가 성공적으로 완료되었거나, 취소되었거나, 중단되었기 때문에(예: 연결이 끊어졌기 때문에) 다운로드가 중지될 때마다 발생합니다. download 인수는 완료된 다운로드 인스턴스의 상태를 보유합니다.

참고: 해당 핸들러는 onDownloadFinished 입니다.


downloadRequested(WebEngineDownloadRequest download)

이 신호는 다운로드가 트리거될 때마다 전송됩니다. download 인수는 다운로드 상태를 보유합니다. WebEngineDownloadRequest::accept ()로 다운로드를 명시적으로 수락해야 하며 그렇지 않으면 다운로드가 기본적으로 취소됩니다.

참고: 해당 핸들러는 onDownloadRequested 입니다.


[since QtWebEngine 1.9] presentNotification(WebEngineNotification notification)

이 신호는 새로 생성된 사용자 알림이 있을 때마다 발신됩니다. notification 인수는 데이터를 쿼리하고 상호 작용할 WebEngineNotification 인스턴스를 보유합니다.

참고: 해당 핸들러는 onPresentNotification 입니다.

이 신호는 QtWebEngine 1.9에 도입되었습니다.


메서드 문서

[since QtWebEngine 1.3] void clearHttpCache()

프로필의 캐시 항목을 제거합니다.

참고: 지우기 작업이 진행되는 동안 프로필에서 새 탐색이나 어떤 작업도 시작하지 마세요. clearHttpCacheCompleted () 신호는 완료를 알립니다.

이 메서드는 QtWebEngine 1.3에 도입되었습니다.

WebEngineProfile::cachePath 및 clearHttpCacheCompleted()도 참조하세요 .


[since 6.8] list<webEnginePermission> listAllPermissions()

현재 권한 저장소에 있는 단일 권한을 나타내는 webEnginePermission 개체의 list 를 반환합니다. 반환된 목록에는 이 프로필에 대해 이전에 부여/거부된 모든 권한이 포함됩니다( 영구 유형인 경우).

참고: persistentPermissionPolicy 속성이 AskEveryTime 로 설정된 경우 빈 목록이 반환됩니다.

이 메서드는 Qt 6.8에 도입되었습니다.

queryPermission(), listPermissionsForOrigin(), listPermissionsForPermissionType() 및 webEnginePermission::isPersistent()도 참조하세요 .


[since 6.8] list<webEnginePermission> listPermissionsForOrigin(url securityOrigin)

현재 권한 저장소에 있는 단일 권한을 나타내는 webEnginePermission 개체의 list 를 반환합니다. 반환된 목록에는 이 프로필에 대해 특정 securityOrigin 과 관련된 이전에 부여/거부된 모든 권한이 포함됩니다( 영구 유형인 경우).

참고: 권한은 원본별로 부여되므로 제공된 securityOrigin 은 원본 형태로 제거되고 반환된 목록에는 해당 원본에 대한 모든 권한이 포함됩니다. 따라서 https://www.example.com/some/page.html 을 전달하는 것은 https://www.example.com/ 만 전달하는 것과 동일합니다.

참고: persistentPermissionPolicy()가 AskEveryTime 로 설정된 경우 빈 리스트를 반환합니다.

이 메서드는 Qt 6.8에 도입되었습니다.

queryPermission(), listAllPermissions(), listPermissionsForPermissionType() 및 webEnginePermission::isPersistent()도 참조하십시오 .


[since 6.8] list<webEnginePermission> listPermissionsForPermissionType(WebEnginePermission.PermissionType permissionType)

현재 권한 저장소에 있는 단일 권한을 나타내는 webEnginePermission 객체의 list 를 반환합니다. 반환된 목록에는 제공된 permissionType 의 이전에 부여/거부된 모든 권한이 포함됩니다. permissionType이 영구적이지 않은 경우 목록은 비어 있습니다.

참고: persistentPermissionPolicy()가 AskEveryTime 로 설정된 경우 빈 목록이 반환됩니다.

이 메서드는 Qt 6.8에 도입되었습니다.

queryPermission(), listAllPermissions(), listPermissionsForOrigin() 및 webEnginePermission::isPersistent()도 참조하세요 .


[since 6.8] void queryPermission(url securityOrigin, WebEnginePermission.PermissionType permissionType)

제공된 securityOrigin 및 permissionType 에 대한 단일 권한에 해당하는 webEnginePermission 객체를 반환합니다. 이 객체는 권한의 현재 상태를 쿼리하거나 변경하는 데 사용할 수 있습니다. 권한이 이미 존재할 필요는 없으며, 반환된 객체는 웹사이트가 권한을 사용할 것으로 알려진 경우 권한을 미리 부여하는 데 사용될 수도 있습니다.

참고: 이 함수는 영구 권한 유형에만 사용할 수 있습니다. 비영구적인 permissionType 로 호출하면 잘못된 객체가 반환됩니다.

이 메서드는 Qt 6.8에 도입되었습니다.

listAllPermissions(), listPermissionsForOrigin() 및 listPermissionsForPermissionType()도 참조하세요 .


© 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.