ContextQMD
Back to Content

Device Memory API

files/en-us/web/api/device_memory_api/index.md

latest1.4 KB
Original Source

{{DefaultAPISidebar("Device Memory API")}}{{securecontext_header}}{{AvailableInWorkers}}

The capabilities of a client device largely depend on the amount of available RAM. Traditionally, developers had to use heuristics and either benchmark a device or infer device capabilities based on other factors like the device manufacturer or User Agent strings.

Determining device memory

There are two ways to determine the approximate amount of RAM a device has: use the Device Memory JavaScript API or accept Client Hints.

JavaScript API

You may query the approximate amount of RAM a device has by retrieving {{DOMxRef("Navigator.deviceMemory")}} or {{DOMxRef("WorkerNavigator.deviceMemory")}}.

js
const RAM = navigator.deviceMemory;

Client Hints

You may also use the Client Hints HTTP Header with the Device-Memory directive to retrieve the same approximate RAM capacity.

Interfaces

Extensions to other interfaces

  • {{domxref("Navigator.deviceMemory")}} {{ReadOnlyInline}}
    • : Returns the approximate amount of device memory in gigabytes.
  • {{domxref("WorkerNavigator.deviceMemory")}} {{ReadOnlyInline}}
    • : Returns the approximate amount of device memory in gigabytes.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{HTTPHeader("Sec-CH-Device-Memory")}} header