webEnginePermission QML Value Type

특정 원본 URL에 부여되거나 거부된 단일 권한의 상태에 액세스하고 수정하는 데 사용되는 개체입니다. 자세히...

속성

• isValid : bool
• origin : url
• permissionType : enumeration
• state : enumeration

방법

• void deny()
• void grant()
• void isPersistent(WebEnginePermission.PermissionType permissionType)
• void reset()

자세한 설명

일반적인 사용 패턴은 다음과 같습니다:

1. 웹사이트에서 특정 기능을 요청하여 WebEngineView::permissionRequested 시그널을 트리거합니다;
2. 신호 핸들러는 사용자에게 권한을 부여할지 여부를 묻는 프롬프트를 트리거합니다;
3. 사용자가 결정을 내리면 애플리케이션은 grant() 또는 deny()를 호출합니다;

또는 이미 부여된 권한을 수정하려는 애플리케이션은 WebEngineProfile::listAllPermissions()를 사용하여 프로필과 연결된 기존 권한 목록을 가져오거나 WebEngineProfile::queryPermission()를 사용하여 특정 권한에 대한 webEnginePermission 객체를 가져올 수 있습니다.

origin 속성은 webEnginePermission이 연결된 출처를 쿼리하는 데 사용할 수 있으며, permissionType 속성은 연결된 기능을 설명합니다. 웹사이트 출처는 해당 웹사이트의 스키마, 호스트 이름 및 포트의 조합입니다. 권한은 오리진별로 부여되므로 https://www.example.com:12345/some/page.html 웹 페이지가 권한을 요청하면 https://www.example.com:12345/ 오리진에 권한이 부여됩니다.

permissionType 열거는 Qt WebEngine 에서 지원하는 모든 권한 유형을 설명합니다. 일부 권한 유형만 브라우징 세션 사이에 기억되며 영구적입니다. 비영구적 권한은 웹사이트에서 요청할 때마다 사용자에게 쿼리합니다. 권한 유형이 영구적인지 여부는 런타임에 정적 메서드 WebEnginePermission::isPersistent()를 사용하여 확인할 수 있습니다.

영구 권한은 활성 WebEngineProfile 에 저장되며 수명은 WebEngineProfile::persistentPermissionsPolicy 값에 따라 달라집니다. 기본적으로 명명된 프로필은 디스크에 권한을 저장하는 반면, 오프더레코드 프로필은 메모리에 권한을 저장합니다(프로필이 삭제되면 삭제됨). 저장된 권한은 다음에 웹사이트가 요청할 때 사용자에게 쿼리하지 않고 사용자가 처음에 선택한 해상도에 따라 자동으로 허용되거나 거부됩니다. 저장된 권한을 지우려면 reset()를 호출합니다.

반면 비영구적 권한은 관련 WebEngineView 이 다른 URL로 이동하거나 삭제될 때까지만 사용할 수 있습니다.

웹엔진퍼미션이 유효한 상태인지 여부는 isValid 속성을 사용하여 확인할 수 있습니다. 유효하지 않은 객체의 경우 grant(), deny() 또는 reset()로 호출하면 아무 작업도 수행하지 않지만 state 으로 호출하면 항상 WebEnginePermission::Invalid가 반환됩니다.

WebEngineView::permissionRequested, WebEngineProfile::queryPermission() 및 WebEngineProfile::listAllPermissions()도 참조하세요 .

프로퍼티 문서

메서드 문서