QWebEngineScript Class
QWebEngineScript 클래스는 자바스크립트 프로그램을 캡슐화합니다. 더 보기...
| 헤더: | #include <QWebEngineScript> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| QML에서: | WebEngineScript |
공용 형
| enum | InjectionPoint { DocumentCreation, DocumentReady, Deferred } |
| enum | ScriptWorldId { MainWorld, ApplicationWorld, UserWorld } |
공용 함수
| QWebEngineScript() | |
| QWebEngineScript(const QWebEngineScript &other) | |
| ~QWebEngineScript() | |
| QWebEngineScript::InjectionPoint | injectionPoint() const |
| QString | name() const |
| bool | runsOnSubFrames() const |
| void | setInjectionPoint(QWebEngineScript::InjectionPoint p) |
| void | setName(const QString &scriptName) |
| void | setRunsOnSubFrames(bool on) |
| void | setSourceCode(const QString &scriptSource) |
| void | setSourceUrl(const QUrl &url) |
| void | setWorldId(quint32 id) |
| QString | sourceCode() const |
| QUrl | sourceUrl() const |
| void | swap(QWebEngineScript &other) |
| quint32 | worldId() const |
| bool | operator!=(const QWebEngineScript &other) const |
| QWebEngineScript & | operator=(const QWebEngineScript &other) |
| bool | operator==(const QWebEngineScript &other) const |
상세 설명
QWebEngineScript는 웹 콘텐츠를 로드하는 동안 injectionPoint()에 의해 결정되는 여러 지점에서 JavaScript 엔진에 소위 사용자 스크립트를 프로그래밍 방식으로 삽입할 수 있게 해줍니다.
스크립트는 웹 콘텐츠에서 제공되는 나머지 JavaScript와 함께 기본 JavaScript 월드에서 실행되거나 자체적으로 분리된 월드에서 실행될 수 있습니다. 페이지의 DOM은 어느 월드에서나 액세스할 수 있지만 한 월드에 정의된 함수의 JavaScript 변수는 다른 월드에서 액세스할 수 없습니다. ScriptWorldId 에서는 이를 위해 미리 정의된 몇 가지 ID를 제공합니다.
Qt 5.8부터 다음과 같은 Greasemonkey 속성이 지원됩니다: @exclude, @include, @name, @match, @run-at.
단일 페이지 또는 동일한 프로필을 공유하는 여러 페이지와 관련된 스크립트 모음에 액세스하려면 QWebEnginePage::scripts() 및 QWebEngineProfile::scripts()을 사용합니다.
스크립트 주입도참조하세요 .
회원 유형 문서
enum QWebEngineScript::InjectionPoint
이 열거형은 스크립트 삽입 타이밍을 설명합니다:
| 상수 | 값 | 설명 |
|---|---|---|
QWebEngineScript::DocumentCreation | 2 | 문서가 생성되는 즉시 스크립트가 실행됩니다. 이 값은 DOM 작업에는 적합하지 않습니다. |
QWebEngineScript::DocumentReady | 1 | 스크립트는 DOM이 준비되는 즉시 실행됩니다. 이는 자바스크립트에서 DOMContentLoaded 이벤트가 실행되는 것과 동일합니다. |
QWebEngineScript::Deferred | 0 | 스크립트는 페이지 로드가 완료될 때 또는 문서가 준비된 후 500ms 중 먼저 도래하는 시점에 실행됩니다. |
enum QWebEngineScript::ScriptWorldId
이 열거형은 사용자 스크립트를 다른 월드에 격리하기 위해 미리 정의된 월드 ID를 제공합니다:
| 상수 | 값 | 설명 |
|---|---|---|
QWebEngineScript::MainWorld | 0 | 페이지의 웹 콘텐츠가 사용하는 월드입니다. 특정 시나리오에서 웹 콘텐츠에 사용자 지정 기능을 노출하는 데 유용할 수 있습니다. |
QWebEngineScript::ApplicationWorld | 1 | 자바스크립트로 구현된 애플리케이션 수준 기능에 사용되는 기본 격리된 월드입니다. |
QWebEngineScript::UserWorld | 2 | 애플리케이션이 더 많은 월드를 사용하지 않는 경우 사용자가 설정한 스크립트에서 사용하는 첫 번째 격리된 월드입니다. 일반적으로 해당 기능이 애플리케이션 사용자에게 노출되는 경우 각 개별 스크립트는 자체 격리된 월드를 가져야 합니다. |
멤버 함수 문서
QWebEngineScript::QWebEngineScript()
널 스크립트를 작성합니다.
QWebEngineScript::QWebEngineScript(const QWebEngineScript &other)
other 의 내용을 사용하여 사용자 스크립트를 작성합니다.
[noexcept] QWebEngineScript::~QWebEngineScript()
스크립트를 삭제합니다.
QWebEngineScript::InjectionPoint QWebEngineScript::injectionPoint() const
로딩 프로세스에서 스크립트가 실행될 지점을 반환합니다. 기본값은 QWebEngineScript::Deferred 입니다.
참고: 속성 injectionPoint에 대한 게터 함수입니다.
setInjectionPoint()도 참조하세요 .
QString QWebEngineScript::name() const
스크립트의 이름을 반환합니다. QWebEngineScriptCollection 에서 특정 스크립트를 검색하는 데 유용할 수 있습니다.
참고: 속성 이름에 대한 게터 함수입니다.
setName() 및 QWebEngineScriptCollection::find()도 참조하세요 .
bool QWebEngineScript::runsOnSubFrames() const
스크립트가 페이지의 모든 프레임에서 실행되는 경우 true, 메인 프레임에서만 실행되는 경우 false 을 반환합니다.
참고: 런온서브프레임 속성에 대한 게터 함수입니다.
setRunsOnSubFrames()도 참조하세요 .
void QWebEngineScript::setInjectionPoint(QWebEngineScript::InjectionPoint p)
스크립트를 실행할 지점을 p 로 설정합니다.
참고: 속성에 대한 세터 함수 injectionPoint.
injectionPoint() 및 InjectionPoint도 참조하세요 .
void QWebEngineScript::setName(const QString &scriptName)
스크립트 이름을 scriptName 로 설정합니다.
참고: 속성에 대한 세터 함수 name.
name()도 참조하세요 .
void QWebEngineScript::setRunsOnSubFrames(bool on)
on 이 true 을 반환하면 메인 프레임 외에 서브 프레임에서도 스크립트를 실행합니다.
참고: runsOnSubFrames 속성에 대한 세터 함수.
runsOnSubFrames()도 참조하세요 .
void QWebEngineScript::setSourceCode(const QString &scriptSource)
스크립트 소스를 scriptSource 로 설정합니다.
참고: 속성에 대한 세터 함수 sourceCode.
sourceCode()도 참조하세요 .
void QWebEngineScript::setSourceUrl(const QUrl &url)
사용자 스크립트의 원격 소스 위치를 url 로 설정합니다.
setSourceCode()와 달리 이 함수를 사용하면 디스크에 저장된 경우와 같이 메모리에 아직 로드되지 않은 사용자 스크립트를 참조할 수 있습니다.
이 값을 설정하면 스크립트의 sourceCode 주소가 변경됩니다.
참고: 현재 파일 기반 소스만 지원됩니다.
참고: 속성에 대한 설정자 함수 sourceUrl.
sourceUrl() 및 setSourceCode()도 참조하세요 .
void QWebEngineScript::setWorldId(quint32 id)
이 스크립트를 실행할 때 고립된 월드의 월드 ID를 id 로 설정합니다.
0 와 256 사이여야 합니다.
참고: 속성의 설정자 함수 worldId.
worldId()도 참조하세요 .
QString QWebEngineScript::sourceCode() const
스크립트의 소스를 반환합니다.
참고: sourceCode 속성에 대한 게터 함수입니다.
setSourceCode()도 참조하세요 .
QUrl QWebEngineScript::sourceUrl() const
사용자 스크립트의 원격 소스 위치(있는 경우)를 반환합니다.
참고: sourceUrl 속성에 대한 게터 함수입니다.
setSourceUrl()도 참조하세요 .
[noexcept] void QWebEngineScript::swap(QWebEngineScript &other)
스크립트의 내용을 other 의 내용으로 바꿉니다.
quint32 QWebEngineScript::worldId() const
스크립트가 실행되는 월드를 정의하는 월드 ID를 반환합니다.
참고: worldId 프로퍼티에 대한 게터 함수입니다.
setWorldId()도 참조하세요 .
bool QWebEngineScript::operator!=(const QWebEngineScript &other) const
스크립트가 other 과 같지 않으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
QWebEngineScript &QWebEngineScript::operator=(const QWebEngineScript &other)
other 을 스크립트에 할당합니다.
bool QWebEngineScript::operator==(const QWebEngineScript &other) const
스크립트가 other 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
© 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.
