ladybird/Libraries/LibWeb/HTML/Navigator.h
Niccolo Antonelli-Dziri 9f4a712e57 LibWeb: Add basics for the Permissions API
This adds the basic infrastructure for the Permissions API, including
the `Permissions` and `PermissionStatus` interfaces. The API is exposed
via `navigator.permissions` on both `Window` and `WorkerGlobalScope`.

- `is_permission_supported` is hardcoded to return false.
- The `query()` method checks for a secure context but rejects all
queries since no powerful features are supported yet.

The permission store and permission key related methods and algorithms.
Ability for the user agent to store the permissions entries.

Passes a few more subtests in `permissions/`.

https://wpt.live/permissions/idlharness.any.html

https://wpt.live/permissions/idlharness.any.worker.html

https://wpt.live/permissions/edge-cases.https.html

This one behaves differently because now the `query` property is
defined. And the last subtest passes for the wrong reason.
"Querying "fullscreen" permission with "allowWithoutGesture" false
is unsupported"
but in fact everything is currently unsupported.

https://wpt.live/fullscreen/api/permission.tentative.https.html

permission is marked as experimental in Navigator and WorkerNavigator,
so tests that now pass actually don't because the tests don't have
access to the interfaces.
2026-05-11 21:01:01 +02:00

130 lines
4.7 KiB
C++

/*
* Copyright (c) 2022, Andrew Kaster <akaster@serenityos.org>
*
* SPDX-License-Identifier: BSD-2-Clause
*/
#pragma once
#include <LibWeb/Bindings/PlatformObject.h>
#include <LibWeb/EncryptedMediaExtensions/NavigatorEncryptedMediaExtensionsPartial.h>
#include <LibWeb/GPC/GlobalPrivacyControl.h>
#include <LibWeb/Gamepad/NavigatorGamepad.h>
#include <LibWeb/HTML/MimeTypeArray.h>
#include <LibWeb/HTML/NavigatorBeacon.h>
#include <LibWeb/HTML/NavigatorConcurrentHardware.h>
#include <LibWeb/HTML/NavigatorDeviceMemory.h>
#include <LibWeb/HTML/NavigatorID.h>
#include <LibWeb/HTML/NavigatorLanguage.h>
#include <LibWeb/HTML/NavigatorOnLine.h>
#include <LibWeb/HTML/PluginArray.h>
#include <LibWeb/HTML/UserActivation.h>
#include <LibWeb/MediaCapabilitiesAPI/MediaCapabilities.h>
#include <LibWeb/MediaCapture/MediaDevices.h>
#include <LibWeb/Serial/Serial.h>
#include <LibWeb/StorageAPI/NavigatorStorage.h>
namespace Web::HTML {
class Navigator
: public Bindings::PlatformObject
, public NavigatorBeaconPartial
, public NavigatorConcurrentHardwareMixin
, public NavigatorDeviceMemoryMixin
, public Gamepad::NavigatorGamepadPartial
, public GlobalPrivacyControl::GlobalPrivacyControlMixin
, public EncryptedMediaExtensions::NavigatorEncryptedMediaExtensionsPartial
, public NavigatorIDMixin
, public NavigatorLanguageMixin
, public NavigatorOnLineMixin
, public StorageAPI::NavigatorStorage {
WEB_PLATFORM_OBJECT(Navigator, Bindings::PlatformObject);
GC_DECLARE_ALLOCATOR(Navigator);
public:
[[nodiscard]] static GC::Ref<Navigator> create(JS::Realm&);
// FIXME: Implement NavigatorContentUtilsMixin
// NavigatorCookies
// FIXME: Hook up to Agent level state
// https://html.spec.whatwg.org/multipage/system-state.html#dom-navigator-cookieenabled
bool cookie_enabled() const { return true; }
// NavigatorPlugins
// https://html.spec.whatwg.org/multipage/system-state.html#dom-navigator-javaenabled
bool java_enabled() const { return false; }
bool pdf_viewer_enabled() const;
bool webdriver() const;
[[nodiscard]] GC::Ref<MimeTypeArray> mime_types();
[[nodiscard]] GC::Ref<PluginArray> plugins();
[[nodiscard]] GC::Ref<Clipboard::Clipboard> clipboard();
[[nodiscard]] GC::Ref<Geolocation::Geolocation> geolocation();
[[nodiscard]] GC::Ref<Serial::Serial> serial();
[[nodiscard]] GC::Ref<UserActivation> user_activation();
[[nodiscard]] GC::Ref<CredentialManagement::CredentialsContainer> credentials();
[[nodiscard]] GC::Ref<WebIDL::Promise> get_battery();
[[nodiscard]] GC::Ref<WebXR::XRSystem> xr();
[[nodiscard]] GC::Ref<PermissionsAPI::Permissions> permissions();
GC::Ref<ServiceWorker::ServiceWorkerContainer> service_worker();
GC::Ref<MediaCapabilitiesAPI::MediaCapabilities> media_capabilities();
GC::Ref<MediaCapture::MediaDevices> media_devices();
static WebIDL::Long max_touch_points();
virtual ~Navigator() override;
protected:
virtual void visit_edges(Cell::Visitor&) override;
private:
explicit Navigator(JS::Realm&);
virtual void initialize(JS::Realm&) override;
// ^StorageAPI::NavigatorStorage
virtual Bindings::PlatformObject const& this_navigator_storage_object() const override { return *this; }
GC::Ptr<PluginArray> m_plugin_array;
GC::Ptr<MimeTypeArray> m_mime_type_array;
// https://w3c.github.io/clipboard-apis/#dom-navigator-clipboard
GC::Ptr<Clipboard::Clipboard> m_clipboard;
// https://w3c.github.io/geolocation/#navigator_interface
GC::Ptr<Geolocation::Geolocation> m_geolocation;
// https://wicg.github.io/serial/#extensions-to-the-navigator-interface
GC::Ptr<Serial::Serial> m_serial;
// https://html.spec.whatwg.org/multipage/interaction.html#dom-navigator-useractivation
GC::Ptr<UserActivation> m_user_activation;
// https://w3c.github.io/ServiceWorker/#navigator-serviceworker
GC::Ptr<ServiceWorker::ServiceWorkerContainer> m_service_worker_container;
// https://w3c.github.io/media-capabilities/#dom-navigator-mediacapabilities
GC::Ptr<MediaCapabilitiesAPI::MediaCapabilities> m_media_capabilities;
// https://w3c.github.io/mediacapture-main/#dom-navigator-mediadevices
GC::Ptr<MediaCapture::MediaDevices> m_media_devices;
// https://w3c.github.io/webappsec-credential-management/#framework-credential-management
GC::Ptr<CredentialManagement::CredentialsContainer> m_credentials;
// https://w3c.github.io/battery/
GC::Ptr<WebIDL::Promise> m_battery_promise;
// https://immersive-web.github.io/webxr/#dom-navigator-xr
GC::Ptr<WebXR::XRSystem> m_xr;
// https://w3c.github.io/permissions/#navigator-and-workernavigator-extension
GC::Ptr<PermissionsAPI::Permissions> m_permissions;
};
}