Skip to Content
Platform.Ontology

Presentation API

Lets a page show itself on a second screen such as a Chromecast.

Asks you firstHardware and accessoriesCastingWeb browsersWhile you use it

In one line

Can show itself on a second screen you choose, like a Chromecast

Lets a page show itself on a second screen such as a Chromecast.

Sees which nearby display receivers exist only after the person picks one; lets a page cast to TVs.

What it can and can't do

What the user does: You tap Cast and pick a screen from the list.

It can

  • List nearby screens you can show the page on
  • Show a page or video on the screen you pick
  • Send messages to the second screen while it runs

It cannot

  • Pick a screen without you choosing
  • Cast on Firefox, Safari or iPhone
  • See other devices on your network beyond the list
  • Cast after you close the page

How it differs between platforms: Chrome and Edge support it. Firefox and Safari, including iPhone, do not.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported472015-12-01None
EdgeSupported792020-01-15None
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidSupported472015-12-02None
Samsung InternetSupported5.02016-12-15None

How a site asks for it

APInew PresentationRequest(urls).start(), PresentationConnection.send(), navigator.presentation.defaultRequest
Browser compat keysapi.PresentationRequest
How access is grantedpicker
What the user seesCast device chooser
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsPer origin
How to take it backSite settings
Inside an iframeSame as top level; cross-origin iframes need a permissions policy where listed

Typical flow

  1. Call the API
  2. Browser applies its access rules
  3. Page receives the result

Data you get

What comes back: Lets a page show itself on a second screen such as a Chromecast.
Shape: object
How often: on demand

FieldTypeUnitRangePrecision
connection.stateenumNoneconnecting, connected, closed, terminatedNot listed
PresentationAvailability.valuebooleanNonetrue or falseNot listed

Technical limits

  • No device list without a picker click
  • No Firefox, Safari or iOS
  • Needs same network receivers

The story

What it is

A page can send itself to a second screen, like a Chromecast.

For you

You tap a Cast button, pick a screen from a list and the page shows up on the TV. Your phone becomes the remote.

For makers

Makers can build second screen experiences, like slides or games that use a TV and a phone as a controller. It brings big screen use to the web.

Where you see it

TypeExampleApps
productivityYou present slides on a TV while your phone shows speaker notes.Google Slides
gamesA party game shows the board on the TV and uses phones as controllers.Jackbox
mediaA music site shows lyrics on a big screen.None named
educationA teacher casts a quiz to the classroom projector.Kahoot
liveA fitness class page shows the workout on the TV and heart rate on the phone.None named
smart-homeA dashboard page appears on a kitchen display.None named

Risks

  • Casting to wrong screen
  • Shared with nearby devices

What the platform says

Good uses and abuse

Legitimate uses

  • Slide decks on TV
  • Digital signage

Known abuse

  • None notable

Scores

ScoreValueMeaning
Sensitivity2 of 5How revealing the data is
Utility2 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2016, Chrome 47: Presentation API ships

Sources

How well checked: Checked against real behavior.

On this page