/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* vim: set ts=8 sts=2 et sw=2 tw=80: */ /* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ #ifndef mozilla_dom_Navigator_h #define mozilla_dom_Navigator_h #include "mozilla/MemoryReporting.h" #include "mozilla/dom/BindingDeclarations.h" #include "mozilla/dom/Fetch.h" #include "mozilla/dom/Nullable.h" #include "mozilla/ErrorResult.h" #include "nsWrapperCache.h" #include "nsHashKeys.h" #include "nsInterfaceHashtable.h" #include "nsString.h" #include "nsTArray.h" #include "nsWeakPtr.h" #include "mozilla/dom/MediaKeySystemAccessManager.h" class nsPluginArray; class nsMimeTypeArray; class nsPIDOMWindowInner; class nsIDOMNavigatorSystemMessages; class nsINetworkProperties; class nsIPrincipal; class nsIURI; namespace mozilla { namespace dom { class BodyExtractorBase; class Geolocation; class systemMessageCallback; class MediaDevices; struct MediaStreamConstraints; class WakeLock; class ArrayBufferOrArrayBufferViewOrBlobOrFormDataOrUSVStringOrURLSearchParams; class ServiceWorkerContainer; class DOMRequest; class CredentialsContainer; } // namespace dom } // namespace mozilla //***************************************************************************** // Navigator: Script "navigator" object //***************************************************************************** namespace mozilla { namespace dom { class Permissions; namespace battery { class BatteryManager; } // namespace battery class Promise; class MozIdleObserver; class Gamepad; class GamepadServiceTest; class NavigatorUserMediaSuccessCallback; class NavigatorUserMediaErrorCallback; class MozGetUserMediaDevicesSuccessCallback; struct MIDIOptions; namespace network { class Connection; } // namespace network class Presentation; class LegacyMozTCPSocket; class VRDisplay; class VRServiceTest; class StorageManager; class MediaCapabilities; class Navigator final : public nsISupports , public nsWrapperCache { public: explicit Navigator(nsPIDOMWindowInner* aInnerWindow); NS_DECL_CYCLE_COLLECTING_ISUPPORTS NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_CLASS(Navigator) static void Init(); void Invalidate(); nsPIDOMWindowInner *GetWindow() const { return mWindow; } void RefreshMIMEArray(); size_t SizeOfIncludingThis(mozilla::MallocSizeOf aMallocSizeOf) const; /** * For use during document.write where our inner window changes. */ void SetWindow(nsPIDOMWindowInner *aInnerWindow); /** * Called when the inner window navigates to a new page. */ void OnNavigation(); void GetProduct(nsAString& aProduct); void GetLanguage(nsAString& aLanguage); void GetAppName(nsAString& aAppName, CallerType aCallerType) const; void GetAppVersion(nsAString& aAppName, CallerType aCallerType, ErrorResult& aRv) const; void GetPlatform(nsAString& aPlatform, CallerType aCallerType, ErrorResult& aRv) const; void GetUserAgent(nsAString& aUserAgent, CallerType aCallerType, ErrorResult& aRv) const; bool OnLine(); void RegisterProtocolHandler(const nsAString& aScheme, const nsAString& aURL, const nsAString& aTitle, ErrorResult& aRv); void RegisterContentHandler(const nsAString& aMIMEType, const nsAString& aURL, const nsAString& aTitle, ErrorResult& aRv); nsMimeTypeArray* GetMimeTypes(ErrorResult& aRv); nsPluginArray* GetPlugins(ErrorResult& aRv); Permissions* GetPermissions(ErrorResult& aRv); void GetDoNotTrack(nsAString& aResult); Geolocation* GetGeolocation(ErrorResult& aRv); Promise* GetBattery(ErrorResult& aRv); static void AppName(nsAString& aAppName, bool aUsePrefOverriddenValue); static nsresult GetPlatform(nsAString& aPlatform, bool aUsePrefOverriddenValue); static nsresult GetAppVersion(nsAString& aAppVersion, bool aUsePrefOverriddenValue); static nsresult GetUserAgent(nsPIDOMWindowInner* aWindow, bool aIsCallerChrome, nsAString& aUserAgent); // Clears the user agent cache by calling: // Navigator_Binding::ClearCachedUserAgentValue(this); void ClearUserAgentCache(); bool Vibrate(uint32_t aDuration); bool Vibrate(const nsTArray& aDuration); void SetVibrationPermission(bool aPermitted, bool aPersistent); uint32_t MaxTouchPoints(); void GetAppCodeName(nsAString& aAppCodeName, ErrorResult& aRv); void GetOscpu(nsAString& aOscpu, CallerType aCallerType, ErrorResult& aRv) const; void GetVendorSub(nsAString& aVendorSub); void GetVendor(nsAString& aVendor); void GetProductSub(nsAString& aProductSub); bool CookieEnabled(); void GetBuildID(nsAString& aBuildID, CallerType aCallerType, ErrorResult& aRv) const; bool JavaEnabled() { return false; } uint64_t HardwareConcurrency(); bool TaintEnabled() { return false; } void AddIdleObserver(MozIdleObserver& aObserver, ErrorResult& aRv); void RemoveIdleObserver(MozIdleObserver& aObserver, ErrorResult& aRv); already_AddRefed MozTCPSocket(); network::Connection* GetConnection(ErrorResult& aRv); MediaDevices* GetMediaDevices(ErrorResult& aRv); void GetGamepads(nsTArray >& aGamepads, ErrorResult& aRv); GamepadServiceTest* RequestGamepadServiceTest(); already_AddRefed GetVRDisplays(ErrorResult& aRv); void GetActiveVRDisplays(nsTArray>& aDisplays) const; VRServiceTest* RequestVRServiceTest(); bool IsWebVRContentDetected() const; bool IsWebVRContentPresenting() const; void RequestVRPresentation(VRDisplay& aDisplay); nsINetworkProperties* GetNetworkProperties(); already_AddRefed RequestMIDIAccess(const MIDIOptions& aOptions, ErrorResult& aRv); Presentation* GetPresentation(ErrorResult& aRv); bool SendBeacon(const nsAString& aUrl, const Nullable& aData, ErrorResult& aRv); void MozGetUserMedia(const MediaStreamConstraints& aConstraints, NavigatorUserMediaSuccessCallback& aOnSuccess, NavigatorUserMediaErrorCallback& aOnError, CallerType aCallerType, ErrorResult& aRv); void MozGetUserMediaDevices(const MediaStreamConstraints& aConstraints, MozGetUserMediaDevicesSuccessCallback& aOnSuccess, NavigatorUserMediaErrorCallback& aOnError, uint64_t aInnerWindowID, const nsAString& aCallID, ErrorResult& aRv); already_AddRefed ServiceWorker(); mozilla::dom::CredentialsContainer* Credentials(); static bool Webdriver(); void GetLanguages(nsTArray& aLanguages); StorageManager* Storage(); static void GetAcceptLanguages(nsTArray& aLanguages); dom::MediaCapabilities* MediaCapabilities(); // WebIDL helper methods static bool HasUserMediaSupport(JSContext* /* unused */, JSObject* /* unused */); nsPIDOMWindowInner* GetParentObject() const { return GetWindow(); } virtual JSObject* WrapObject(JSContext* cx, JS::Handle aGivenProto) override; // GetWindowFromGlobal returns the inner window for this global, if // any, else null. static already_AddRefed GetWindowFromGlobal(JSObject* aGlobal); already_AddRefed RequestMediaKeySystemAccess(const nsAString& aKeySystem, const Sequence& aConfig, ErrorResult& aRv); private: RefPtr mMediaKeySystemAccessManager; public: void NotifyVRDisplaysUpdated(); void NotifyActiveVRDisplaysChanged(); private: virtual ~Navigator(); // This enum helps SendBeaconInternal to apply different behaviors to body // types. enum BeaconType { eBeaconTypeBlob, eBeaconTypeArrayBuffer, eBeaconTypeOther }; bool SendBeaconInternal(const nsAString& aUrl, BodyExtractorBase* aBody, BeaconType aType, ErrorResult& aRv); RefPtr mMimeTypes; RefPtr mPlugins; RefPtr mPermissions; RefPtr mGeolocation; RefPtr mBatteryManager; RefPtr mBatteryPromise; RefPtr mConnection; RefPtr mCredentials; RefPtr mMediaDevices; RefPtr mServiceWorkerContainer; nsCOMPtr mWindow; RefPtr mPresentation; RefPtr mGamepadServiceTest; nsTArray > mVRGetDisplaysPromises; RefPtr mVRServiceTest; nsTArray mRequestedVibrationPattern; RefPtr mStorageManager; RefPtr mMediaCapabilities; }; } // namespace dom } // namespace mozilla #endif // mozilla_dom_Navigator_h