A user account is required in order to edit this wiki, but we've had to disable public user registrations due to spam.

To request an account, ask an autoconfirmed user on Chat (such as one of these permanent autoconfirmed members).

Contexts: Difference between revisions

From WHATWG Wiki
Jump to navigation Jump to search
(Identify contexts and how to use them.)
 
(Add link to Fetch section)
 
(20 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== How to use a context ==


# Identify context.
# Determine whether to fetch resource based on CSP directives and type hint, if any.
# Fetch resource.
# Set no-sniff flag on resource (based on URL), if necessary.
# Handle resource.
# Sniff resource.
# Process and display resource or prompt to download resource, as appropriate.


== Context types ==
== Context types ==
Line 6: Line 14:
! Context
! Context
! Definition
! Definition
! Type Hint
! Scriptable?
! Used in HTML?
! Used in HTML?
! Used in CSS?
! Used in CSS?
! Sniffing Algorithm
! Scriptable?
! CSP Directive
! Type Hint
! [[MIME Sniffing|Sniffing]] Algorithm
|-
|-
| browsing
| browsing (navigate)
| [http://www.whatwg.org/specs/web-apps/current-work/#browsing-context HTML]
| [http://www.whatwg.org/specs/web-apps/current-work/multipage/#browsing-context HTML]
| Yes
| No?
| Yes
|
| —
| —
| rowspan="2" | [http://mimesniff.spec.whatwg.org/#mime-type-sniffing-algorithm MIME type sniffing algorithm]
|-
| nested browsing (navigate)
| [http://www.whatwg.org/specs/web-apps/current-work/multipage/#nested-browsing-context HTML]
| Yes
| Yes
| No?
| Yes
| [https://w3c.github.io/webappsec/specs/content-security-policy/#frame-src <code>frame-src</code>]
|
|-
| connection
|
| Yes
| Yes
| No?
| No?
| [http://mimesniff.spec.whatwg.org/#mime-type-sniffing-algorithm MIME type sniffing algorithm]
| Yes?
| [https://w3c.github.io/webappsec/specs/content-security-policy/#connect-src <code>connect-src</code>]
|
|
|-
|-
| image
| image
|  
|  
|
| No
| Yes
| Yes
| Yes
| Yes
| No
| [https://w3c.github.io/webappsec/specs/content-security-policy/#img-src <code>img-src</code>]
|
| [http://mimesniff.spec.whatwg.org/#rules-for-sniffing-images-specifically rules for sniffing images specifically]
| [http://mimesniff.spec.whatwg.org/#rules-for-sniffing-images-specifically rules for sniffing images specifically]
|-
|-
| audio/video
| audio/video
|  
|  
| Yes
| No?
| No
| [https://w3c.github.io/webappsec/specs/content-security-policy/#media-src <code>media-src</code>]
|
| [http://mimesniff.spec.whatwg.org/#rules-for-sniffing-audio-and-video-specifically rules for sniffing audio and video specifically]
|-
| plugin
|  
|  
| No
| Yes
| Yes
| No?
| No?
| [http://mimesniff.spec.whatwg.org/#rules-for-sniffing-audio-and-video-specifically rules for sniffing audio and video specifically]
| Yes
| [https://w3c.github.io/webappsec/specs/content-security-policy/#object-src <code>object-src</code>]
|
| [http://mimesniff.spec.whatwg.org/#rules-for-sniffing-in-a-plugin-context rules for sniffing in a plugin context]
|-
|-
| style
| style
|  
|  
| @<code>type</code> or "<code>text/css</code>"
| No
| Yes
| Yes
| Yes?
| Yes?
|  
| No
| [https://w3c.github.io/webappsec/specs/content-security-policy/#style-src <code>style-src</code>]
| @<code>type</code> or "<code>text/css</code>"
| [http://mimesniff.spec.whatwg.org/#rules-for-sniffing-in-a-style-context rules for sniffing in a style context]
|-
|-
| script
| script
|  
|  
| @<code>type</code> or "<code>text/javascript</code>"
| Yes?
| Yes
| Yes
| No?
| No?
|  
| Yes?
| [https://w3c.github.io/webappsec/specs/content-security-policy/#script-src <code>script-src</code>]
| @<code>type</code> or "<code>text/javascript</code>"
| [http://mimesniff.spec.whatwg.org/#rules-for-sniffing-in-a-script-context rules for sniffing in a script context]
|-
|-
| font
| font
|  
|  
| <code>format</code>()
| No
| No
| Yes
| No
| No
| Yes
| [https://w3c.github.io/webappsec/specs/content-security-policy/#font-src <code>font-src</code>]
| <code>format()</code>
| [http://mimesniff.spec.whatwg.org/#rules-for-sniffing-fonts-specifically rules for sniffing fonts specifically]
| [http://mimesniff.spec.whatwg.org/#rules-for-sniffing-fonts-specifically rules for sniffing fonts specifically]
|-
|-
| text track
| text track
|  
|  
| "<code>text/vtt</code>"
| Yes
| No
| No
| Yes
| No
| No
|
| "<code>text/vtt</code>"
|  
|  
|-
|-
| cache manifest
| cache manifest
|  
|  
| "<code>text/cache-manifest</code>"
| Yes
| No
| No
| Yes
| No
| No
|
| "<code>text/cache-manifest</code>"
|  
|  
|}
|}


== How to use a context ==
== Context triggers ==
 
{| class="wikitable" |
! Context
! HTML Triggers
! CSS Triggers
! Other Triggers
|-
! browsing
|
|
|
|-
! nested browsing
| <code>&lt;iframe></code>, <code>&lt;object></code> (sometimes), <code>&lt;frame></code>
|
|
|-
! connection
|
|
| EventSource, WebSocket, XMLHttpRequest
|-
! image
| <code>&lt;img></code>, <code>&lt;link rel=icon></code>, <code>&lt;input type=image></code>, <code>&lt;object></code> (sometimes)
| <code>background-image</code>
|
|-
! audio/video
| <code>&lt;audio></code>, <code>&lt;video></code>
|
|
|-
! plugin
| <code>&lt;embed></code>, <code>&lt;object></code> (sometimes)
|
|
|-
! style
| <code>&lt;link rel=stylesheet></code>
| <code>@import</code>?
|
|-
! script
| <code>&lt;script src></code>
|
|
|-
! font
| —
| <code>@font-face</code>
| FontFace#load(), FontFaceSet#load()
|-
! text track
| <code>&lt;track></code>
| —
|
|-
! cache manifest
| <code>&lt;html manifest></code>
| —
|
|}
 
== Issues ==
 
* What about SVG?
* What about XSLT?
* document.load()? (Seems similar enough to connect-src.)
* What about CSS masks?
* What about CSS shapes?
 
== See also ==
 
* [https://fetch.spec.whatwg.org/#concept-request-context Fetch Standard: request context]


# Identify context.
[[Category:Spec coordination]]
# Determine whether to fetch resource based on type hint, if any.
# Set no-sniff flag on resource, if necessary.
# Fetch resource.
# Handle resource.
# Sniff resource.
# Process and display resource or prompt to download resource, as appropriate.

Latest revision as of 12:30, 1 April 2015

How to use a context

  1. Identify context.
  2. Determine whether to fetch resource based on CSP directives and type hint, if any.
  3. Fetch resource.
  4. Set no-sniff flag on resource (based on URL), if necessary.
  5. Handle resource.
  6. Sniff resource.
  7. Process and display resource or prompt to download resource, as appropriate.

Context types

Context Definition Used in HTML? Used in CSS? Scriptable? CSP Directive Type Hint Sniffing Algorithm
browsing (navigate) HTML Yes No? Yes MIME type sniffing algorithm
nested browsing (navigate) HTML Yes No? Yes frame-src
connection Yes No? Yes? connect-src
image Yes Yes No img-src rules for sniffing images specifically
audio/video Yes No? No media-src rules for sniffing audio and video specifically
plugin Yes No? Yes object-src rules for sniffing in a plugin context
style Yes Yes? No style-src @type or "text/css" rules for sniffing in a style context
script Yes No? Yes? script-src @type or "text/javascript" rules for sniffing in a script context
font No Yes No font-src format() rules for sniffing fonts specifically
text track Yes No No "text/vtt"
cache manifest Yes No No "text/cache-manifest"

Context triggers

Context HTML Triggers CSS Triggers Other Triggers
browsing
nested browsing <iframe>, <object> (sometimes), <frame>
connection EventSource, WebSocket, XMLHttpRequest
image <img>, <link rel=icon>, <input type=image>, <object> (sometimes) background-image
audio/video <audio>, <video>
plugin <embed>, <object> (sometimes)
style <link rel=stylesheet> @import?
script <script src>
font @font-face FontFace#load(), FontFaceSet#load()
text track <track>
cache manifest <html manifest>

Issues

  • What about SVG?
  • What about XSLT?
  • document.load()? (Seems similar enough to connect-src.)
  • What about CSS masks?
  • What about CSS shapes?

See also