QWebEnginePermission Class

상세 설명

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

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

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

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

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

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

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

isValid() 속성을 사용하여 QWebEnginePermission이 유효한 상태인지 확인할 수 있습니다. 유효하지 않은 개체의 경우 grant(), deny() 또는 reset()를 호출하면 아무 작업도 수행하지 않지만 state()를 호출하면 항상 QWebEnginePermission::Invalid 를 반환합니다.