QWebEngineProfile Class

멤버 함수 문서

[explicit] QWebEngineProfile::QWebEngineProfile(QObject *parent = nullptr)

부모 parent 를 사용하여 새 오프더레코드 프로필을 만듭니다.

오프더레코드 프로필은 로컬 머신에 기록을 남기지 않으며 영구적인 데이터나 캐시가 없습니다. 따라서 HTTP 캐시는 메모리에만 있을 수 있고 쿠키는 비영구적일 수 있습니다. 이러한 설정을 변경해도 아무런 효과가 없습니다.

isOffTheRecord()도 참조하세요 .

[explicit] QWebEngineProfile::QWebEngineProfile(const QString &storageName, QObject *parent = nullptr)

스토리지 이름 storageName 과 부모 parent 로 새 프로필을 생성합니다.

저장소 이름은 고유해야 합니다.

그렇지 않으면 캐시 및 영구 데이터가 디스크로 완전히 플러시되지 않을 수 있으므로 디스크 기반 QWebEngineProfile은 애플리케이션 종료 시 또는 그 전에 삭제해야 합니다.

storageName()도 참조하십시오 .

QString QWebEngineProfile::cachePath() const

캐시에 사용된 경로를 반환합니다.

기본적으로 이 경로는 QtWebengine/StorageName 특정 하위 디렉토리의 StandardPaths::CacheLocation 아래에 있습니다.

setCachePath(), storageName() 및 QStandardPaths::writableLocation()도 참조하세요 .

void QWebEngineProfile::clearAllVisitedLinks()

방문한 링크 데이터베이스에서 모든 링크를 지웁니다.

clearVisitedLinks()도 참조하세요 .

void QWebEngineProfile::clearHttpCache()

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

QWebEngineProfile::clearHttpCacheCompleted()도 참조하세요 .

[signal, since 6.7] void QWebEngineProfile::clearHttpCacheCompleted()

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

이 함수는 Qt 6.7에 도입되었습니다.

QWebEngineProfile::clearHttpCache()도 참조하십시오 .

void QWebEngineProfile::clearVisitedLinks(const QList<QUrl> &urls)

방문한 링크 데이터베이스에서 urls 의 링크를 지웁니다.

clearAllVisitedLinks()도 참조하세요 .

QWebEngineClientCertificateStore *QWebEngineProfile::clientCertificateStore()

프로필의 클라이언트 인증서 저장소를 반환합니다.

[since 6.8] QWebEngineClientHints *QWebEngineProfile::clientHints() const

이 브라우징 컨텍스트와 관련된 클라이언트 힌트 설정을 반환합니다.

이 기능은 Qt 6.8에 도입되었습니다.

QWebEngineClientHints 를참조하세요 .

QWebEngineCookieStore *QWebEngineProfile::cookieStore()

이 프로필의 쿠키 저장소를 반환합니다.

[static] QWebEngineProfile *QWebEngineProfile::defaultProfile()

기본 프로필을 반환합니다.

기본 프로필은 오프더레코드입니다.

storageName()도 참조하세요 .

QString QWebEngineProfile::downloadPath() const

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

setDownloadPath() 및 QStandardPaths::writableLocation()도 참조하세요 .

[signal] void QWebEngineProfile::downloadRequested(QWebEngineDownloadRequest *download)

이 신호는 다운로드가 트리거될 때마다 전송됩니다. download 인수는 다운로드 상태를 유지합니다. QWebEngineDownloadRequest::accept ()로 다운로드를 명시적으로 수락해야 하며 그렇지 않으면 기본적으로 다운로드가 취소됩니다. 다운로드 항목은 프로필에 의해 상위 항목이 됩니다. 수락되지 않으면 신호가 전송된 후 즉시 삭제됩니다. 이 신호는 대기 중인 연결에서는 사용할 수 없습니다.

QWebEngineDownloadRequest 및 QWebEnginePage::download()도 참조하세요 .

QString QWebEngineProfile::httpAcceptLanguage() const

Accept-Language HTTP 요청 헤더 필드의 값을 반환합니다.

setHttpAcceptLanguage()도 참조하세요 .

int QWebEngineProfile::httpCacheMaximumSize() const

HTTP 캐시의 최대 크기를 바이트 단위로 반환합니다.

QtWebEngine 에 의해 크기가 자동으로 제어되는 경우 0 를 반환합니다.

setHttpCacheMaximumSize() 및 httpCacheType()도 참조하세요 .

QWebEngineProfile::HttpCacheType QWebEngineProfile::httpCacheType() const

사용된 HTTP 캐시 유형을 반환합니다.

프로필이 오프더레코드인 경우 MemoryHttpCache 가 반환됩니다.

setHttpCacheType() 및 cachePath()도 참조하세요 .

QString QWebEngineProfile::httpUserAgent() const

브라우저를 식별하기 위해 HTTP와 함께 전송된 사용자 에이전트 문자열을 반환합니다.

setHttpUserAgent() 및 Windows 애플리케이션 매니페스트도참조하세요 .

void QWebEngineProfile::installUrlSchemeHandler(const QByteArray &scheme, QWebEngineUrlSchemeHandler *handler)

프로필에 사용자 지정 URL 스키마 scheme 에 대한 핸들러 handler 를 등록합니다.

애플리케이션을 시작할 때 먼저 QWebEngineUrlScheme::registerScheme 에 스키마를 등록해야 합니다.

bool QWebEngineProfile::isOffTheRecord() const

컴퓨터에 기록을 남기지 않는 오프더레코드 프로필인 경우 true 을 반환합니다.

이렇게 하면 쿠키와 HTTP 캐시가 메모리에 강제로 저장되지만 다른 모든 정상적으로 영구적인 데이터도 메모리에 강제로 저장됩니다.

[since 6.5] bool QWebEngineProfile::isPushServiceEnabled() const

푸시 메시징 서비스가 활성화된 경우 true 을 반환합니다.

이 기능은 Qt 6.5에 도입되었습니다.

setPushServiceEnabled()도 참조하세요 .

bool QWebEngineProfile::isSpellCheckEnabled() const

맞춤법 검사기가 활성화된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

setSpellCheckEnabled()도 참조하세요 .

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listAllPermissions() const

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

이 함수는 Qt 6.8에 도입되었습니다.

queryPermission(), QWebEnginePermission::PermissionType, 및 QWebEnginePermission::isPersistent()도 참조하세요 .

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listPermissionsForOrigin(const QUrl &securityOrigin) const

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

이 함수는 Qt 6.8에 도입되었습니다.

queryPermission(), QWebEnginePermission::PermissionType, QWebEnginePermission::isPersistent()도 참조하세요 .

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listPermissionsForPermissionType(QWebEnginePermission::PermissionType permissionType) const

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

이 함수는 Qt 6.8에 도입되었습니다.

queryPermission(), QWebEnginePermission::PermissionType, 및 QWebEnginePermission::isPersistent()도 참조하세요 .

QWebEngineProfile::PersistentCookiesPolicy QWebEngineProfile::persistentCookiesPolicy() const

영구 쿠키에 대한 현재 정책을 반환합니다.

프로필이 오프더레코드인 경우 NoPersistentCookies 가 반환됩니다.

setPersistentCookiesPolicy()도 참조하세요 .

[since 6.8] QWebEngineProfile::PersistentPermissionsPolicy QWebEngineProfile::persistentPermissionsPolicy() const

영구 권한에 대한 현재 정책을 반환합니다.

오프더레코드 프로필은 디스크에 데이터를 저장할 수 없으므로 StoreInMemory 또는 AskEveryTime 만 반환할 수 있습니다.

이 함수는 Qt 6.8에 도입되었습니다.

QWebEngineProfile::PersistentPermissionsPolicy 및 setPersistentPermissionsPolicy()도 참조하세요 .

QString QWebEngineProfile::persistentStoragePath() const

브라우저 및 웹 콘텐츠의 영구 데이터를 저장하는 데 사용되는 경로를 반환합니다.

영구 데이터에는 영구 쿠키, HTML5 로컬 저장소 및 방문한 링크가 포함됩니다.

기본적으로 이 위치는 QtWebengine/StorageName 특정 하위 디렉터리의 QStandardPaths::DataLocation 아래에 있습니다.

setPersistentStoragePath(), storageName() 및 QStandardPaths::writableLocation()도 참조하세요 .

[since 6.8] QWebEnginePermission QWebEngineProfile::queryPermission(const QUrl &securityOrigin, QWebEnginePermission::PermissionType permissionType) const

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

이를 사용하여 비영구적 유형의 권한을 미리 부여할 수 있습니다. 이렇게 하면 다음 번에 관련 출처가 있는 웹사이트가 권한을 요청할 때까지 권한이 부여된(또는 거부된) 상태로 유지됩니다. 이때 권한의 수명은 특정 웹 페이지의 수명에 연결되며, 해당 웹 페이지를 벗어나면 권한이 무효화됩니다.

이 기능은 Qt 6.8에 도입되었습니다.

listAllPermissions(), listPermissionsForOrigin(), listPermissionsForPermissionType() 및 QWebEnginePermission::PermissionType 을참조하세요 .

void QWebEngineProfile::removeAllUrlSchemeHandlers()

프로필에 설치된 모든 사용자 지정 URL 스키마 핸들러를 제거합니다.

void QWebEngineProfile::removeUrlScheme(const QByteArray &scheme)

프로필에서 사용자 지정 URL 구성표 scheme 를 제거합니다.

removeUrlSchemeHandler()도 참조하세요 .

void QWebEngineProfile::removeUrlSchemeHandler(QWebEngineUrlSchemeHandler *handler)

프로필에서 사용자 정의 URL 스키마 핸들러 handler 를 제거합니다.

removeUrlScheme()도 참조하세요 .

[since 6.2] void QWebEngineProfile::requestIconForIconURL(const QUrl &url, int desiredSizeInPixel, std::function<void (const QIcon &, const QUrl &)> iconAvailableCallback) const

데이터베이스에서 지정된 url 아이콘을 요청합니다. 각 프로필에는 고유한 아이콘 데이터베이스가 있으며 영구 저장소에 저장되므로 네트워크 연결 없이도 저장된 아이콘에 액세스할 수 있습니다. 아이콘을 데이터베이스에 저장하려면 이전에 아이콘을 로드해야 합니다.

url 아이콘의 URL을 지정합니다. 사용 가능한 아이콘이 두 개 이상인 경우 desiredSizeInPixel 에 가장 가까운 크기의 아이콘이 반환됩니다. 결과 아이콘의 크기는 desiredSizeInPixel 로 조정됩니다. desiredSizeInPixel이 0이면 사용 가능한 가장 큰 아이콘이 반환됩니다.

이 함수는 비동기식이며 결과는 iconAvailableCallback 에 의해 반환됩니다. 아이콘 요청이 수행되면 콜백이 호출됩니다. 요청된 아이콘을 사용할 수 있는 경우 첫 번째 매개변수(유형이 QIcon)가 결과가 됩니다. 그렇지 않으면 null입니다.

두 번째 매개 변수는 요청된 아이콘의 URL을 저장합니다. 아이콘을 가져올 수 없는 경우 비어 있습니다.

이 기능은 Qt 6.2에 도입되었습니다.

requestIconForPageURL()도 참조하세요 .

[since 6.2] void QWebEngineProfile::requestIconForPageURL(const QUrl &url, int desiredSizeInPixel, std::function<void (const QIcon &, const QUrl &, const QUrl &)> iconAvailableCallback) const

데이터베이스에서 이 프로필로 이전에 로드한 페이지의 아이콘을 요청합니다. 각 프로필에는 고유한 아이콘 데이터베이스가 있으며 영구 저장소에 저장되므로 네트워크 연결 없이도 저장된 아이콘에 액세스할 수 있습니다. 아이콘을 데이터베이스에 저장하려면 이전에 로드한 적이 있어야 합니다.

url 아이콘을 요청할 페이지의 URL을 지정합니다. 사용 가능한 아이콘이 두 개 이상인 경우 desiredSizeInPixel 에 가장 가까운 크기의 아이콘이 반환됩니다. 결과 아이콘의 크기는 desiredSizeInPixel 로 조정됩니다. desiredSizeInPixel이 0이면 사용 가능한 가장 큰 아이콘이 반환됩니다.

이 함수는 비동기식이며 결과는 iconAvailableCallback 에 의해 반환됩니다. 아이콘 요청이 수행되면 콜백이 호출됩니다. 요청된 아이콘을 사용할 수 있는 경우 첫 번째 매개변수(유형이 QIcon)가 결과가 됩니다. 그렇지 않으면 null입니다.

두 번째 매개 변수는 요청된 아이콘의 URL을 저장합니다. 아이콘을 가져올 수 없는 경우 비어 있습니다.

세 번째 매개 변수는 아이콘이 할당된 페이지의 URL을 저장합니다.

이 기능은 Qt 6.2에 도입되었습니다.

requestIconForIconURL()도 참조하세요 .

QWebEngineScriptCollection *QWebEngineProfile::scripts() const

이 프로필을 공유하는 모든 페이지에 삽입된 스크립트 모음을 반환합니다.

QWebEngineScriptCollection, QWebEngineScript, QWebEnginePage::scripts() 및 스크립트 삽입도 참조하세요 .

void QWebEngineProfile::setCachePath(const QString &path)

디스크 캐시에 사용되는 기본 경로를 재정의하여 path 로 설정합니다.

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

cachePath()도 참조하세요 .

void QWebEngineProfile::setDownloadPath(const QString &path)

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

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

downloadPath()도 참조하세요 .

void QWebEngineProfile::setHttpAcceptLanguage(const QString &httpAcceptLanguage)

Accept-Language HTTP 요청 헤더 필드의 값을 httpAcceptLanguage 로 설정합니다.

httpAcceptLanguage()도 참조하세요 .

void QWebEngineProfile::setHttpCacheMaximumSize(int maxSize)

HTTP 캐시의 최대 크기를 maxSize 바이트로 설정합니다.

0 로 설정하면 QtWebEngine 에 의해 크기가 자동으로 제어됩니다.

httpCacheMaximumSize() 및 setHttpCacheType()도 참조하세요 .

void QWebEngineProfile::setHttpCacheType(QWebEngineProfile::HttpCacheType httpCacheType)

HTTP 캐시 유형을 httpCacheType 로 설정합니다.

httpCacheType(), setCachePath() 및 clearHttpCache()도 참조하세요 .

void QWebEngineProfile::setHttpUserAgent(const QString &userAgent)

기본 사용자 에이전트 문자열을 재정의하여 userAgent 로 설정합니다.

httpUserAgent()도 참조하세요 .

void QWebEngineProfile::setNotificationPresenter(std::function<void (std::unique_ptr<QWebEngineNotification>)> notificationPresenter)

notificationPresenter 함수를 보낸 알림 표시를 담당하는 함수로 설정합니다.

QWebEngineNotification도 참조하세요 .

void QWebEngineProfile::setPersistentCookiesPolicy(QWebEngineProfile::PersistentCookiesPolicy newPersistentCookiesPolicy)

영구 쿠키에 대한 정책을 newPersistentCookiesPolicy 으로 설정합니다.

persistentCookiesPolicy()도 참조하세요 .

[since 6.8] void QWebEngineProfile::setPersistentPermissionsPolicy(QWebEngineProfile::PersistentPermissionsPolicy newPersistentPermissionsPolicy)

영구 권한에 대한 정책을 newPersistentPermissionsPolicy 으로 설정합니다.

이 함수는 Qt 6.8에 도입되었습니다.

QWebEngineProfile::PersistentPermissionsPolicy 및 persistentPermissionsPolicy()도 참조하십시오 .

void QWebEngineProfile::setPersistentStoragePath(const QString &path)

영구 웹 엔진 데이터를 저장하는 데 사용되는 기본 경로를 재정의합니다.

path 가 널 문자열로 설정된 경우 기본 경로가 복원됩니다.

persistentStoragePath()도 참조하세요 .

[since 6.5] void QWebEngineProfile::setPushServiceEnabled(bool enable)

enable 이 true 인 경우 푸시 메시징 서비스를 활성화하고 그렇지 않으면 비활성화합니다.

이 기능은 Qt 6.5에 도입되었습니다.

isPushServiceEnabled()도 참조하세요 .

void QWebEngineProfile::setSpellCheckEnabled(bool enable)

enable 이 true 인 경우 맞춤법 검사기를 활성화하고 그렇지 않으면 비활성화합니다.

isSpellCheckEnabled()도 참조하세요 .

void QWebEngineProfile::setSpellCheckLanguages(const QStringList &languages)

맞춤법 검사기의 현재 목록( languages )을 설정합니다. 각 언어는 .bdic 사전의 이름과 일치해야 합니다. 예를 들어 en-US 언어는 en-US.bdic 사전 파일을 로드합니다.

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

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

spellCheckLanguages()도 참조하세요 .

void QWebEngineProfile::setUrlRequestInterceptor(QWebEngineUrlRequestInterceptor *interceptor)

요청 인터셉터 싱글톤 interceptor 을 등록하여 URL 요청을 가로챕니다.

프로필은 포인터의 소유권을 갖지 않습니다.

QWebEngineUrlRequestInfo 및 QWebEngineUrlRequestInterceptor 을참조하세요 .

QWebEngineSettings *QWebEngineProfile::settings() const

이 프로필의 모든 페이지에 대한 기본 설정을 반환합니다.

QStringList QWebEngineProfile::spellCheckLanguages() const

맞춤법 검사기에서 사용하는 언어 목록을 반환합니다.

setSpellCheckLanguages()도 참조하세요 .

QString QWebEngineProfile::storageName() const

프로필의 스토리지 이름을 반환합니다.

저장소 이름은 디스크를 사용하는 각 프로필에 영구 데이터 및 캐시를 위한 별도의 하위 디렉터리를 지정하는 데 사용됩니다.

const QWebEngineUrlSchemeHandler *QWebEngineProfile::urlSchemeHandler(const QByteArray &scheme) const

URL 스키마에 대한 사용자 정의 URL 스키마 핸들러 등록을 반환합니다 scheme.

bool QWebEngineProfile::visitedLinksContainsUrl(const QUrl &url) const

url 이 프로필에서 방문한 링크로 간주되는 경우 true 을 반환합니다.