QWebEngineClientHints Class

QWebEngineClientHints 클래스는 프로필에서 사용하는 사용자 에이전트 클라이언트 힌트를 커스터마이징할 수 있는 객체를 제공합니다. 더 보기...

헤더: #include <QWebEngineClientHints>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake: QT += webenginecore
이후: Qt 6.8
상속합니다: QObject

속성

공공 기능

QString arch() const
QString bitness() const
QString fullVersion() const
QVariantMap fullVersionList() const
bool isAllClientHintsEnabled()
bool isMobile() const
bool isWow64() const
QString model() const
QString platform() const
QString platformVersion() const
void resetAll()
void setAllClientHintsEnabled(bool enabled)
void setArch(const QString &)
void setBitness(const QString &)
void setFullVersion(const QString &)
void setFullVersionList(const QVariantMap &)
void setIsMobile(bool)
void setIsWow64(bool)
void setModel(const QString &)
void setPlatform(const QString &)
void setPlatformVersion(const QString &)

상세 설명

QWebEngineClientHints를 사용하면 사용자 에이전트 응답 및 요청 헤더와 JavaScript API를 통해 브라우저 및 플랫폼 정보 노출을 구성할 수 있습니다.

이 API를 통해 액세스하는 정보는 저엔트로피와 고엔트로피 힌트의 두 그룹으로 나뉩니다. 저엔트로피 힌트(platformmobile)는 많은 정보를 제공하지 않는 힌트로, API는 모든 요청에서 액세스할 수 있도록 하며 QWebEngineClientHints::setAllClientHintsEnabled 에서 비활성화할 수 없습니다.

다른 모든 힌트는 높은 엔트로피 힌트이며, 더 많은 정보를 제공할 가능성이 있으므로 QWebEngineClientHints::setAllClientHintsEnabled 에서 비활성화할 수 있습니다.

각 프로필 객체에는 해당 브라우징 컨텍스트에 대한 클라이언트 힌트 설정을 구성하는 자체 QWebEngineClientHints 객체가 있습니다. 웹 엔진 프로필에 대해 클라이언트 힌트가 구성되지 않은 경우 시스템에서 기본값이 추론됩니다.

QWebEngineProfile::clientHints() 및 QQuickWebEngineProfile::clientHints()도 참조하세요 .

속성 문서

arch : QString

자바스크립트에서 Sec-CH-UA-Arch HTTP 헤더 및 architecture NavigatorUAData 멤버의 값입니다.

액세스 함수:

QString arch() const
void setArch(const QString &)

bitness : QString

자바스크립트에서 Sec-CH-UA-Bitness HTTP 헤더 및 bitness NavigatorUAData 멤버의 값입니다.

액세스 함수:

QString bitness() const
void setBitness(const QString &)

fullVersion : QString

자바스크립트에서 Sec-CH-UA-Full-Version HTTP 헤더 및 uaFullVersion NavigatorUAData 멤버의 값입니다.

액세스 함수:

QString fullVersion() const
void setFullVersion(const QString &)

fullVersionList : QVariantMap

자바스크립트에서 Sec-CH-UA-Full-Version-List HTTP 헤더와 fullVersionList NavigatorUAData 멤버의 값입니다.

브랜드 이름과 버전 번호 쌍을 QVariantMap. 제공된 값은 현재 사용 중인 크롬 버전과 반무작위 브랜드에 따라 자동으로 확장됩니다.

액세스 기능:

QVariantMap fullVersionList() const
void setFullVersionList(const QVariantMap &)

isAllClientHintsEnabled : bool

이 속성은 클라이언트 힌트 HTTP 헤더를 WebEngine 에서 전송할지 여부를 제어합니다.

기본적으로 활성화됩니다.

액세스 함수:

bool isAllClientHintsEnabled()
void setAllClientHintsEnabled(bool enabled)

mobile : bool

자바스크립트에서 Sec-CH-UA-Mobile HTTP 헤더 및 mobile NavigatorUAData 멤버의 값입니다.

비활성화할 수 없습니다.

액세스 기능:

bool isMobile() const
void setIsMobile(bool)

model : QString

자바스크립트에서 Sec-CH-UA-Model HTTP 헤더 및 model NavigatorUAData 멤버의 값입니다.

액세스 함수:

QString model() const
void setModel(const QString &)

platform : QString

자바스크립트에서 Sec-CH-UA-Platform HTTP 헤더 및 platform NavigatorUAData 멤버의 값입니다.

비활성화할 수 없습니다.

액세스 기능:

QString platform() const
void setPlatform(const QString &)

platformVersion : QString

자바스크립트에서 Sec-CH-UA-Platform-Version HTTP 헤더 및 platformVersion NavigatorUAData 멤버의 값입니다.

액세스 함수:

QString platformVersion() const
void setPlatformVersion(const QString &)

wow64 : bool

자바스크립트에서 Sec-CH-UA-Wow64 HTTP 헤더 및 wow64 NavigatorUAData 멤버의 값입니다.

액세스 함수:

bool isWow64() const
void setIsWow64(bool)

멤버 함수 문서

[invokable] void QWebEngineClientHints::resetAll()

모든 클라이언트 힌트 설정을 기본값으로 재설정합니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

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