feat: add permission_handler example, Hash derive, Display impl for PermissionKind/PermissionResponse

F0RLE · F0RLE · commit 794cb8bff3a8 · 2026-02-20T22:25:14.000+03:00
Signed-off-by: F0RLE &lt;lrshka.klim7766@gmail.com&gt;
diff --git a/examples/permission_handler.rs b/examples/permission_handler.rs
@@ -0,0 +1,139 @@
+// Copyright 2020-2023 Tauri Programme within The Commons Conservancy
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-License-Identifier: MIT
+
+//! Example demonstrating the permission handler API.
+//!
+//! This example creates a webview with a simple HTML page that requests
+//! camera, microphone, and geolocation permissions. The permission handler
+//! logs each request and applies a per-kind policy.
+
+use tao::{
+  event::{Event, WindowEvent},
+  event_loop::{ControlFlow, EventLoop},
+  window::WindowBuilder,
+};
+use wry::{PermissionKind, PermissionResponse, WebViewBuilder};
+
+const HTML: &str = r#"
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <title>Permission Handler Example</title>
+  <style>
+    body { font-family: system-ui, sans-serif; padding: 2rem; background: #1a1a2e; color: #eee; }
+    button { padding: 0.75rem 1.5rem; margin: 0.5rem; border: none; border-radius: 8px;
+             background: #0f3460; color: #fff; cursor: pointer; font-size: 1rem; }
+    button:hover { background: #16213e; }
+    #log { margin-top: 1rem; padding: 1rem; background: #16213e; border-radius: 8px;
+           font-family: monospace; white-space: pre-wrap; min-height: 100px; }
+  </style>
+</head>
+<body>
+  <h1>🔐 Permission Handler Demo</h1>
+  <p>Click a button to trigger a permission request. Check the terminal for handler output.</p>
+  <div>
+    <button onclick="requestCamera()">📷 Request Camera</button>
+    <button onclick="requestMicrophone()">🎤 Request Microphone</button>
+    <button onclick="requestGeolocation()">📍 Request Geolocation</button>
+    <button onclick="requestScreen()">🖥️ Request Screen Capture</button>
+  </div>
+  <div id="log">Waiting for permission requests...</div>
+  <script>
+    function log(msg) {
+      document.getElementById('log').textContent += '\n' + msg;
+    }
+    async function requestCamera() {
+      try {
+        const stream = await navigator.mediaDevices.getUserMedia({ video: true });
+        log('✅ Camera granted');
+        stream.getTracks().forEach(t => t.stop());
+      } catch (e) { log('❌ Camera denied: ' + e.message); }
+    }
+    async function requestMicrophone() {
+      try {
+        const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+        log('✅ Microphone granted');
+        stream.getTracks().forEach(t => t.stop());
+      } catch (e) { log('❌ Microphone denied: ' + e.message); }
+    }
+    function requestGeolocation() {
+      navigator.geolocation.getCurrentPosition(
+        pos => log('✅ Geolocation granted: ' + pos.coords.latitude + ', ' + pos.coords.longitude),
+        err => log('❌ Geolocation denied: ' + err.message)
+      );
+    }
+    async function requestScreen() {
+      try {
+        const stream = await navigator.mediaDevices.getDisplayMedia({ video: true });
+        log('✅ Screen capture granted');
+        stream.getTracks().forEach(t => t.stop());
+      } catch (e) { log('❌ Screen capture denied: ' + e.message); }
+    }
+  </script>
+</body>
+</html>
+"#;
+
+fn main() -> wry::Result<()> {
+  let event_loop = EventLoop::new();
+  let window = WindowBuilder::new()
+    .with_title("Permission Handler Example")
+    .build(&event_loop)
+    .unwrap();
+
+  let builder = WebViewBuilder::new()
+    .with_html(HTML)
+    .with_permission_handler(|kind| {
+      println!("[permission] requested: {kind:?}");
+
+      let response = match kind {
+        // Allow media capture
+        PermissionKind::Camera => PermissionResponse::Allow,
+        PermissionKind::Microphone => PermissionResponse::Allow,
+        PermissionKind::DisplayCapture => PermissionResponse::Allow,
+
+        // Let the system handle geolocation (shows native prompt)
+        PermissionKind::Geolocation => PermissionResponse::Prompt,
+
+        // Deny everything else
+        _ => PermissionResponse::Deny,
+      };
+
+      println!("[permission] response: {response:?}");
+      response
+    });
+
+  #[cfg(any(
+    target_os = "windows",
+    target_os = "macos",
+    target_os = "ios",
+    target_os = "android"
+  ))]
+  let _webview = builder.build(&window)?;
+  #[cfg(not(any(
+    target_os = "windows",
+    target_os = "macos",
+    target_os = "ios",
+    target_os = "android"
+  )))]
+  let _webview = {
+    use tao::platform::unix::WindowExtUnix;
+    use wry::WebViewBuilderExtUnix;
+    let vbox = window.default_vbox().unwrap();
+    builder.build_gtk(vbox)?
+  };
+
+  event_loop.run(move |event, _, control_flow| {
+    *control_flow = ControlFlow::Wait;
+
+    if let Event::WindowEvent {
+      event: WindowEvent::CloseRequested,
+      ..
+    } = event
+    {
+      *control_flow = ControlFlow::Exit;
+    }
+  });
+}
diff --git a/src/lib.rs b/src/lib.rs
@@ -538,7 +538,7 @@ pub struct NewWindowFeatures {
 /// Permission types that can be requested by the webview.
 ///
 /// See [`WebViewBuilder::with_permission_handler`].
-#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
 #[non_exhaustive]
 pub enum PermissionKind {
   /// Microphone access permission.
@@ -593,10 +593,35 @@ pub enum PermissionKind {
   Other,
 }
 
+impl std::fmt::Display for PermissionKind {
+  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+    match self {
+      Self::Microphone => write!(f, "microphone"),
+      Self::Camera => write!(f, "camera"),
+      Self::Geolocation => write!(f, "geolocation"),
+      Self::Notifications => write!(f, "notifications"),
+      Self::ClipboardRead => write!(f, "clipboard-read"),
+      Self::DisplayCapture => write!(f, "display-capture"),
+      Self::Midi => write!(f, "midi"),
+      Self::Nfc => write!(f, "nfc"),
+      Self::Bluetooth => write!(f, "bluetooth"),
+      Self::Sensors => write!(f, "sensors"),
+      Self::MediaKeySystemAccess => write!(f, "media-key-system-access"),
+      Self::LocalFonts => write!(f, "local-fonts"),
+      Self::WindowManagement => write!(f, "window-management"),
+      Self::PointerLock => write!(f, "pointer-lock"),
+      Self::AutomaticDownloads => write!(f, "automatic-downloads"),
+      Self::FileSystemAccess => write!(f, "file-system-access"),
+      Self::Autoplay => write!(f, "autoplay"),
+      Self::Other => write!(f, "other"),
+    }
+  }
+}
+
 /// Response for permission requests.
 ///
 /// See [`WebViewBuilder::with_permission_handler`].
-#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default)]
 pub enum PermissionResponse {
   /// Grant the permission.
   Allow,
@@ -609,6 +634,17 @@ pub enum PermissionResponse {
   Prompt,
 }
 
+impl std::fmt::Display for PermissionResponse {
+  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+    match self {
+      Self::Allow => write!(f, "allow"),
+      Self::Deny => write!(f, "deny"),
+      Self::Default => write!(f, "default"),
+      Self::Prompt => write!(f, "prompt"),
+    }
+  }
+}
+
 /// An id for a webview
 pub type WebViewId<'a> = &'a str;
 
