WebEngineScript QML Type

JavaScript 엔진에서 스크립트를 프로그래밍 방식으로 삽입할 수 있습니다. 더 보기...

Import Statement:	`import QtWebEngine`
Since:	QtWebEngine 1.1
In C++:	QWebEngineScript

상속된 멤버를 포함한 모든 멤버 목록

속성

injectionPoint : enumeration
name : string
runsOnSubFrames : bool
sourceCode : string
sourceUrl : url
worldId : enumeration

상세 설명

WebEngineScript 유형을 사용하면 웹 콘텐츠 로딩 중 injectionPoint 에 의해 결정되는 여러 지점에서 JavaScript 엔진에 소위 사용자 스크립트를 프로그래밍 방식으로 삽입할 수 있습니다.

스크립트는 웹 콘텐츠에서 제공되는 나머지 JavaScript와 함께 기본 JavaScript 세계에서 실행되거나 자체적으로 분리된 세계에서 실행될 수 있습니다. 페이지의 DOM은 어느 월드에서나 액세스할 수 있지만 한 월드에 정의된 함수의 JavaScript 변수는 다른 월드에서 액세스할 수 없습니다. worldId 속성은 이를 위해 미리 정의된 몇 가지 ID를 제공합니다.

지원되는 Greasemonkey 속성은 다음과 같습니다: @exclude, @include, @name, @match, 및 @run-at.

웹 보기에 첨부된 스크립트 목록에 액세스하려면 WebEngineScriptCollection 을 사용하세요.

속성 문서

injectionPoint : enumeration

로딩 프로세스에서 스크립트가 실행될 지점입니다. 기본값은 Deferred 입니다.

상수	설명
`WebEngineScript.DocumentCreation`	문서가 생성되는 즉시 스크립트가 실행됩니다. 이 옵션은 DOM 작업에는 적합하지 않습니다.
`WebEngineScript.DocumentReady`	스크립트는 DOM이 준비되는 즉시 실행됩니다. 이는 자바스크립트에서 `DOMContentLoaded` 이벤트가 실행되는 것과 같습니다.
`WebEngineScript.Deferred`	스크립트는 페이지 로드가 완료될 때 또는 문서가 준비된 후 500ms 중 먼저 오는 시점에 실행됩니다.

name : string

스크립트의 이름입니다. WebEngineScriptCollection.find 메서드에서 특정 스크립트를 검색하는 데 유용할 수 있습니다.

runsOnSubFrames : bool

스크립트가 페이지의 모든 프레임에서 실행되는 경우 이 속성을 true, 메인 프레임에서만 실행되는 경우 false 로 설정합니다. 기본값은 false 입니다.

sourceCode : string

이 속성은 사용자 스크립트의 자바스크립트 소스 코드를 보유합니다.

sourceUrl 를참조하세요 .

sourceUrl : url

이 속성은 사용자 스크립트의 원격 소스 위치(있는 경우)를 보유합니다.

sourceCode 과 달리 이 속성을 사용하면 디스크에 저장된 경우와 같이 메모리에 아직 로드되지 않은 사용자 스크립트를 참조할 수 있습니다.

이 속성을 설정하면 스크립트의 sourceCode 이 변경됩니다.

참고: 현재 파일 기반 소스만 지원됩니다.

sourceCode 를참조하세요 .

worldId : enumeration

스크립트가 실행되는 격리된 월드를 정의하는 월드 ID입니다.

상수	설명
`WebEngineScript.MainWorld`	페이지의 웹 콘텐츠가 사용하는 월드입니다. 특정 시나리오에서 웹 콘텐츠에 사용자 지정 기능을 노출하는 데 유용할 수 있습니다.
`WebEngineScript.ApplicationWorld`	자바스크립트로 구현된 애플리케이션 수준 기능에 사용되는 기본 격리된 월드입니다.
`WebEngineScript.UserWorld`	애플리케이션이 더 많은 월드를 사용하지 않는 경우 사용자가 설정한 스크립트에서 사용하는 첫 번째 격리된 월드입니다. 일반적으로 해당 기능이 애플리케이션 사용자에게 노출되는 경우 각 개별 스크립트는 자체 격리된 월드를 가져야 합니다.

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