HTML

The activation behavior of an a or area element element given an event event is:

1. If element has no href attribute, then return.

2. Let hyperlinkSuffix be null.

3. If element is an a element, and event's target is an img with an ismap attribute specified:

   1. Let x and y be 0.

   2. If event's isTrusted attribute is initialized to true, then set x to the distance in CSS pixels from the left edge of the image to the location of the click, and set y to the distance in CSS pixels from the top edge of the image to the location of the click.

   3. If x is negative, set x to 0.

   4. If y is negative, set y to 0.

   5. Set hyperlinkSuffix to the concatenation of U+003F (?), the value of x expressed as a base-ten integer using ASCII digits, U+002C (,), and the value of y expressed as a base-ten integer using ASCII digits.

4. Let userInvolvement be event's user navigation involvement.

5. If the user has expressed a preference to download the hyperlink, then set userInvolvement to "browser UI".

   That is, if the user has expressed a specific preference for downloading, this no longer counts as merely "activation".

6. If element has a download attribute, or if the user has expressed a preference to download the hyperlink, then download the hyperlink created by element with hyperlinkSuffix set to hyperlinkSuffix and userInvolvement set to userInvolvement.

7. Otherwise, follow the hyperlink created by element with hyperlinkSuffix set to hyperlinkSuffix and userInvolvement set to userInvolvement.

A hyperlink element has the following extract an origin steps:

1. If this's url is null, then return null.

2. Return this's url's origin.

When hyperlink elements are created, the user agent must set the url.

A hyperlink element has an associated reinitialize url algorithm, which runs these steps:

1. If the element's url is non-null, its scheme is "blob", and it has an opaque path, then terminate these steps.

2. Set the url.

The origin getter steps are:

1. Reinitialize url.

2. If this's url is null, return the empty string.

3. Return the serialization of this's url's origin.

The protocol getter steps are:

1. Reinitialize url.

2. If this's url is null, return ":".

3. Return this's url's scheme, followed by ":".

The protocol setter steps are:

1. Reinitialize url.

2. If this's url is null, then return.

3. Basic URL parse the given value, followed by ":", with this's url as url and scheme start state as state override.

   Because the URL parser ignores multiple consecutive colons, providing a value of "https:" (or even "https::::") is the same as providing a value of "https".

4. Update href.

The username getter steps are:

1. Reinitialize url.

2. If this's url is null, return the empty string.

3. Return this's url's username.

The username setter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null or url cannot have a username/password/port, then return.

4. Set the username, given url and the given value.

5. Update href.

The password getter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null, then return the empty string.

4. Return url's password.

The password setter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null or url cannot have a username/password/port, then return.

4. Set the password, given url and the given value.

5. Update href.

The host getter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url or url's host is null, return the empty string.

4. If url's port is null, return url's host, serialized.

5. Return url's host, serialized, followed by ":" and url's port, serialized.

The host setter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null or url has an opaque path, then return.

4. Basic URL parse the given value, with url as url and host state as state override.

5. Update href.

The hostname getter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url or url's host is null, return the empty string.

4. Return url's host, serialized.

The hostname setter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null or url has an opaque path, then return.

4. Basic URL parse the given value, with url as url and hostname state as state override.

5. Update href.

The port getter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url or url's port is null, return the empty string.

4. Return url's port, serialized.

The port setter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null or url cannot have a username/password/port, then return.

4. If the given value is the empty string, then set url's port to null.

5. Otherwise, basic URL parse the given value, with url as url and port state as state override.

6. Update href.

The pathname getter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null, then return the empty string.

4. Return the result of URL path serializing url.

The pathname setter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null or url has an opaque path, then return.

4. Set url's path to the empty list.

5. Basic URL parse the given value, with url as url and path start state as state override.

6. Update href.

The search getter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null, or url's query is either null or the empty string, return the empty string.

4. Return "?", followed by url's query.

The search setter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null, terminate these steps.

4. If the given value is the empty string, set url's query to null.

5. Otherwise:

   1. Let input be the given value with a single leading "?" removed, if any.

   2. Set url's query to the empty string.

   3. Basic URL parse input, with url as url and query state as state override.

6. Update href.

The hash getter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null, or url's fragment is either null or the empty string, return the empty string.

4. Return "#", followed by url's fragment.

The hash setter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null, then return.

4. If the given value is the empty string, set url's fragment to null.

5. Otherwise:

   1. Let input be the given value with a single leading "#" removed, if any.

   2. Set url's fragment to the empty string.

   3. Basic URL parse input, with url as url and fragment state as state override.

6. Update href.

The href getter steps are:

1. Reinitialize url.

2. Let url be this's url.

3. If url is null and this has no href content attribute, return the empty string.

4. Otherwise, if url is null, return this's href content attribute's value.

5. Return url, serialized.

The HTML element insertion steps for a and area elements, given insertedNode, are:

1. If insertedNode is not connected, then return.

2. Consider speculative loads given insertedNode's node document.

The HTML element removing steps for a and area elements, given removedNode, isSubtreeRoot, and oldAncestor are:

1. If oldAncestor is not connected, then return.

2. Consider speculative loads given oldAncestor's node document.

The HTML element moving steps for a and area elements, given movedNode, are:

1. Consider speculative loads given movedNode's node document.

The following attribute change steps, given element, localName, oldValue, value, and namespace, are used for all a and area elements:

1. If namespace is not null, then return.

2. If oldValue equals value, then return.

3. If localName is href, then set the url given element.

   This is only observable for blob: URLs as parsing them involves a Blob URL Store lookup.

4. If localName is href, referrerpolicy, or rel, then consider speculative loads given element's node document.

To update href for an HTMLAnchorElement or HTMLAreaElement element, set the element's href content attribute's value to the element's url, serialized.

The set the url algorithm for HTMLAnchorElement and HTMLAreaElement elements is as follows:

1. Set this element's url to null.

2. If this element's href content attribute is absent, then return.

3. Let url be the result of encoding-parsing a URL given this element's href content attribute's value, relative to this element's node document.

4. If url is not failure, then set this element's url to url.

An element element cannot navigate if any of the following are true:

• element's node document is not fully active; or

• element is not an a element and is not connected.

To get an element's noopener, given an a, area, or form element element, a URL record url, and a string target, perform the following steps. They return a boolean.

1. If element's link types include the noopener or noreferrer keyword, then return true.

2. If element's link types do not include the opener keyword and target is an ASCII case-insensitive match for "_blank", then return true.

3. If url's blob URL entry is not null:

   1. Let blobOrigin be url's blob URL entry's environment's origin.

   2. Let topLevelOrigin be element's relevant settings object's top-level origin.

   3. If blobOrigin is not same site with topLevelOrigin, then return true.

4. falseを返す。

To follow the hyperlink created by an element subject, given an optional hyperlinkSuffix (default null) and an optional userInvolvement (default "none"):

1. If subject cannot navigate, then return.

2. Let targetAttributeValue be the empty string.

3. If subject is an a or area element, then set targetAttributeValue to the result of getting an element's target given subject.

4. Let urlRecord be the result of encoding-parsing a URL given subject's href attribute value, relative to subject's node document.

5. If urlRecord is failure, then return.

6. Let noopener be the result of getting an element's noopener with subject, urlRecord, and targetAttributeValue.

7. Let targetNavigable be the first return value of applying the rules for choosing a navigable given targetAttributeValue, subject's node navigable, and noopener.

8. If targetNavigable is null, then return.

9. Let urlString be the result of applying the URL serializer to urlRecord.

10. If hyperlinkSuffix is non-null, then append it to urlString.

11. Navigate targetNavigable to urlString using subject's node document, with referrerPolicy set to subject's hyperlink referrer policy, userInvolvement set to userInvolvement, and sourceElement set to subject.

    Unlike many other types of navigations, following hyperlinks does not have special "replace" behavior for when documents are not completely loaded. This is true for both user-initiated instances of following hyperlinks, as well as script-triggered ones via, e.g., aElement.click().

The hyperlink referrer policy for an element subject is the value returned by the following steps:

1. If subject's link types includes the noreferrer keyword, then return "no-referrer".

2. Return the current state of subject's referrerpolicy content attribute.

To download the hyperlink created by an element subject, given an optional hyperlinkSuffix (default null) and an optional userInvolvement (default "none"):

1. If subject cannot navigate, then return.

2. If subject's node document's active sandboxing flag set has the sandboxed downloads browsing context flag set, then return.

3. Let urlString be the result of encoding-parsing-and-serializing a URL given subject's href attribute value, relative to subject's node document.

4. If urlString is failure, then return.

5. If hyperlinkSuffix is non-null, then append it to urlString.

6. If userInvolvement is not "browser UI":

   1. Assert: subject has a download attribute.

   2. Let navigation be subject's relevant global object's navigation API.

   3. Let filename be the value of subject's download attribute.

   4. Let continue be the result of firing a download request navigate event at navigation with destinationURL set to urlString, userInvolvement set to userInvolvement, sourceElement set to subject, and filename set to filename.

   5. If continue is false, then return.

   6. Inform the navigation API about aborting navigation given subject's node navigable.

7. Run these steps in parallel:

   1. Optionally, the user agent may abort these steps, if it believes doing so would safeguard the user from a potentially hostile download.

   2. Let request be a new request whose URL is urlString, client is entry settings object, initiator is "download", destination is the empty string, and whose synchronous flag and use-URL-credentials flag are set.

   3. Let response be the result of fetching request.

   4. Handle as a download response with subject's node navigable and null.

To handle as a download a response response with a navigable navigable and a navigation ID or null navigationId:

1. Let suggestedFilename be the result of getting the suggested filename for response.

2. Let download behavior be the result of WebDriver BiDi download will begin with navigable and a new WebDriver BiDi navigation status whose id is navigationId, status is "pending", url is response's URL, and suggestedFilename is suggestedFilename.

3. If download behavior is not null and download behavior's allowed is false:

   1. Invoke WebDriver BiDi download end with navigable and a new WebDriver BiDi navigation status whose id is navigationId, status is "canceled", url is response's URL.

   2. Return.

4. If download behavior is not null, let destinationFolder be download behavior's destinationFolder.

5. Run these steps in parallel:

   1. Run implementation-defined steps to save response for later use. If destinationFolder is not null, the user agent should save the file to that path. If the user agent needs a filename, the user agent should use the suggestedFilename.

   2. If any of the following are true:

      • the download is canceled by the user;

      • the download is canceled by the user agent;

      • an error occurs (for example, a network error, not enough storage, an unavailable destination folder);

      then:

      1. Invoke WebDriver BiDi download end with navigable and a new WebDriver BiDi navigation status whose id is navigationId, status is "canceled", url is response's URL.

      2. Return.

   3. When the download completes successfully, invoke WebDriver BiDi download end with navigable and a new WebDriver BiDi navigation status whose id is navigationId, status is "complete", downloadedFilepath is an absolute path of the downloaded file if available, otherwise null, url is response's URL.

To get the suggested filename for a response response:

このアルゴリズムは、信頼できないサイトからファイルをダウンロードすることに関与するセキュリティの危険性を軽減するために意図され、そしてユーザーエージェントはアルゴリズムに追従するように強く促される。

1. Let filename be the undefined value.

2. If response has a `Content-Disposition` header, that header specifies the attachment disposition type, and the header includes filename information, then let filename have the value specified by the header, and jump to the step labeled sanitize below. [RFC6266]

3. もしあれば、interface originを、開始されたダウンロードをもたらすダウンロードするまたはナビゲートする行動で、ダウンロードDocumentの生成元にする。

4. Let response origin be the origin of the URL of response, unless that URL's scheme component is data, in which case let response origin be the same as the interface origin, if any.

5. interface originがない場合、trusted operationをtrueにする。Otherwise, let trusted operation be true if response origin is the same origin as interface origin, and false otherwise.

6. If trusted operation is true and response has a `Content-Disposition` header and that header includes filename information, then let filename have the value specified by the header, and jump to the step labeled sanitize below. [RFC6266]

7. If the download was not initiated from a hyperlink created by an a or area element, or if the element of the hyperlink from which it was initiated did not have a download attribute when the download was initiated, or if there was such an attribute but its value when the download was initiated was the empty string, then jump to the step labeled no proposed filename.

8. proposed filenameにダウンロードが開始された時点でダウンロードを開始したハイパーリンクの要素のdownload属性の値を持たせる。

9. trusted operationがtrueである場合、filenameにproposed filenameの値を持たせ、かつ下記のサニタイズで標識されるステップにジャンプする。

10. If response has a `Content-Disposition` header and that header specifies the attachment disposition type, let filename have the value of proposed filename, and jump to the step labeled sanitize below. [RFC6266]

11. No proposed filename: If trusted operation is true, or if the user indicated a preference for having the response in question downloaded, let filename have a value derived from the URL of response in an implementation-defined manner, and jump to the step labeled sanitize below.

12. Let filename be set to the user's preferred filename or to a filename selected by the user agent, and jump to the step labeled sanitize below.

    If the algorithm reaches this step, then a download was begun from a different origin than response, and the origin did not mark the file as suitable for downloading, and the download was not initiated by the user. This could be because a download attribute was used to trigger the download, or because response is not of a type that the user agent supports.

    たとえば、敵対的なサーバーが、ユーザーをだまして敵対的なサーバーに由来するデータを考えさせることで、知らないうちに個人情報をダウンロードして敵対的なサーバーに再アップロードするために、ユーザーを取得しようとしている可能性があるため、これは危険であるかもしれない。

    Thus, it is in the user's interests that the user be somehow notified that response comes from quite a different source, and to prevent confusion, any suggested filename from the potentially hostile interface origin should be ignored.

13. サニタイズ：必要に応じて、ユーザーにfilenameに影響を与えることを可能にする。For example, a user agent could prompt the user for a filename, potentially providing the value of filename as determined above as a default value.

14. ローカルファイルシステムに適するようにfilenameを調整する。

    For example, this could involve removing characters that are not legal in filenames, or trimming leading and trailing whitespace.

15. If the platform conventions do not in any way use extensions to determine the types of file on the file system, then return filename as the filename.

16. Let claimed type be the type given by response's Content-Type metadata, if any is known. Let named type be the type given by filename's extension, if any is known. For the purposes of this step, a type is a mapping of a MIME type to an extension.

17. If named type is consistent with the user's preferences (e.g., because the value of filename was determined by prompting the user), then return filename as the filename.

18. If claimed type and named type are the same type (i.e., the type given by response's Content-Type metadata is consistent with the type given by filename's extension), then return filename as the filename.

19. claimed typeが既知である場合、claimed typeに対応する拡張子を追加するためにfilenameを変更する。

    Otherwise, if named type is known to be potentially dangerous (e.g. it will be treated by the platform conventions as a native executable, shell script, HTML application, or executable-macro-capable document), then optionally alter filename to add a known-safe extension (e.g. ".txt").

    この最後の手順は、望ましくないかもしれない、実行可能ファイルをダウンロードすることを不可能にする。As always, implementers are forced to balance security and usability in this matter.

20. Return filename as the filename.

If a hyperlink created by an a or area element has a ping attribute, and the user follows the hyperlink, and the value of the element's href attribute can be parsed, relative to the element's node document, without failure, then the user agent must take the ping attribute's value, split that string on ASCII whitespace, parse each resulting token, relative to the element's node document, and then run these steps for each resulting URL ping URL, ignoring when parsing returns failure:

1. If ping URL's scheme is not an HTTP(S) scheme, then return.

2. Optionally, return. (For example, the user agent might wish to ignore any or all ping URLs in accordance with the user's expressed preferences.)

3. Let settingsObject be the element's node document's relevant settings object.

4. Let request be a new request whose URL is ping URL, method is `POST`, header list is « (`Content-Type`, `text/ping`) », body is `PING`, client is settingsObject, destination is the empty string, credentials mode is "include", referrer is "no-referrer", and whose use-URL-credentials flag is set, and whose initiator type is "ping".

5. Let target URL be the result of encoding-parsing-and-serializing a URL given the element's href attribute's value, relative to the element's node document, and then:

   If the URL of the Document object containing the hyperlink being audited and ping URL have the same origin

   If the origins are different, but the scheme of the URL of the Document containing the hyperlink being audited is not "https"

   request must include a `Ping-From` header with, as its value, the URL of the document containing the hyperlink, and a `Ping-To` HTTP header with, as its value, the target URL.

   そうでなければ

   request must include a `Ping-To` HTTP header with, as its value, target URL. request does not include a `Ping-From` header.

6. Fetch request.

このリンクのタイプをフェッチして処理する適切な時期は次のとおり：

• すでにブラウジングコンテキストに接続されているlink要素で外部リソースリンクが作成されたとき。

• 外部リソースリンクのlink要素がブラウジングコンテキストに接続されたとき。

• すでにブラウジングコンテキストに接続されている外部リソースリンクのlink要素のhref属性が変更されたとき。

The fetch and process the linked resource steps for this type of linked resource, given a link element el, are:

1. Let url be the result of encoding-parsing a URL given el's href attribute's value, relative to el's node document.

2. If url is failure, then return.

3. Let partitionKey be the result of determining the network partition key given el's node document's relevant settings object.

4. The user agent should resolve an origin given partitionKey and url's origin.

   As the results of this algorithm can be cached, future fetches could be faster.

Whenever any of the following conditions occur for a link element el:

• the expect internal resource link is created on el that is already browsing-context connected;

• an expect internal resource link has been created on el and el becomes browsing-context connected;

• an expect internal resource link has been created on el, el is already browsing-context connected, and el's href attribute is set, changed, or removed; or

• an expect internal resource link has been created on el, el is already browsing-context connected, and el's media attribute is set, changed, or removed,

then process el.

To process internal resource link given a link element el, run these steps:

1. Let doc be el's node document.

2. Let url be the result of encoding-parsing a URL given el's href attribute's value, relative to doc.

3. If this fails, or if url does not equal doc's URL with exclude fragments set to true, then unblock rendering on el and return.

4. Let indicatedElement be the result of selecting the indicated part given doc and url.

5. If all of the following are true:

   • doc's current document readiness is "loading";

   • el creates an internal resource link;

   • el is browsing-context connected;

   • el's rel attribute contains expect;

   • el is potentially render-blocking;

   • el's media attribute matches the environment; and

   • indicatedElement is not an element, or is on a stack of open elements of an HTML parser whose associated Document is doc,

   then block rendering on el.

6. Otherwise, unblock rendering on el.

To process internal resource links given a Document doc:

1. For each expect link element link in doc's render-blocking element set, process link.

The following attribute change steps, given element, localName, oldValue, value, and namespace, are used to ensure expect link elements respond to dynamic id and name changes:

1. If namespace is not null, then return.

2. If element is in a stack of open elements of an HTML parser, then return.

3. If any of the following is true:

   • localName is id; or

   • localName is name and element is an a element,

   then process internal resource links given element's node document.

キーワードが何を表すかを決定するために、次のように他のキーワードをさらに解析しなければならない：

1. キーワードが正確に1つのU+0078 LATIN SMALL LETTER XまたはU+0058 LATIN CAPITAL LETTER X文字を含まない場合、このキーワードは何も表さない。Return for that keyword.

2. width stringを"x"または"X"の前の文字列にする。

3. height stringを"x"または"X"の後の文字列にする。

4. width stringまたはheight stringのいずれかがU+0030 DIGIT ZERO（0）文字で開始するまたはASCII数字以外の文字を含む場合、このキーワードは何も表さない。Return for that keyword.

5. widthを取得するためにwidth stringに非負整数を解析するための規則を適用する。

6. heightを取得するためにheight stringに非負整数を解析するための規則を適用する。

7. キーワードは、リソースがwidthデバイスピクセルの幅およびheightのデバイスピクセルの高さをもつビットマップアイコンを含むことを表す。

The linked resource fetch setup steps for this type of linked resource, given a link element el and request request, are:

1. Set request's destination to "image".

2. Return true.

The process a link header steps for this type of linked resource are to do nothing.

In the absence of a link with the icon keyword, for Document objects whose URL's scheme is an HTTP(S) scheme, user agents may instead run these steps in parallel:

1. Let request be a new request whose URL is the URL record obtained by resolving the URL "/favicon.ico" against the Document object's URL, client is the Document object's relevant settings object, destination is "image", synchronous flag is set, credentials mode is "include", and whose use-URL-credentials flag is set.

2. Let response be the result of fetching request.

3. Use response's unsafe response as an icon as if it had been declared using the icon keyword.

For an installed web application, the appropriate times to fetch and process the linked resource for this link type are:

• すでにブラウジングコンテキストに接続されているlink要素で外部リソースリンクが作成されたとき。

• 外部リソースリンクのlink要素がブラウジングコンテキストに接続されたとき。

• すでにブラウジングコンテキストに接続されている外部リソースリンクのlink要素のhref属性が変更されたとき。

The linked resource fetch setup steps for this type of linked resource, given a link element el and request request, are:

1. Let navigable be el's node document's node navigable.

2. If navigable is null, then return false.

3. If navigable is not a top-level traversable, then return false.

4. Set request's initiator to "manifest".

5. Set request's destination to "manifest".

6. Set request's mode to "cors".

7. Set request's credentials mode to the CORS settings attribute credentials mode for el's crossorigin content attribute.

8. Return true.

To process this type of linked resource given a link element el, boolean success, response response, and byte sequence bodyBytes:

1. If response's Content-Type metadata is not a JSON MIME type, then set success to false.

2. If success is true:

   1. Let document URL be el's node document's URL.

   2. Let manifest URL be response's URL.

   3. Let client be el's node document's relevant settings object.

   4. Process the manifest given document URL, manifest URL, bodyBytes, and client. [MANIFEST]

The process a link header steps for this type of linked resource are to do nothing.

このようなリンクのリンクされたリソースをフェッチして処理する適切な時期は次のとおり：

• すでにブラウジングコンテキストに接続されているlink要素で外部リソースリンクが作成されたとき。

• 外部リソースリンクのlink要素がブラウジングコンテキストに接続されたとき。

• すでにブラウジングコンテキストに接続されている外部リソースリンクのlink要素のhref属性が変更されたとき。

The fetch and process the linked resource algorithm for modulepreload links, given a link element el, is as follows:

1. If el's href attribute's value is the empty string, then return.

2. Let destination be the current state of el's as attribute (a destination), or "script" if it is in no state.

3. If destination is not a module preload destination, then queue an element task on the networking task source given el to fire an event named error at el, and return.

4. Let url be the result of encoding-parsing a URL given el's href attribute's value, relative to el's node document.

5. If url is failure, then return.

6. Let settings object be el's node document's relevant settings object.

7. Let credentials mode be the CORS settings attribute credentials mode for el's crossorigin attribute.

8. Let cryptographic nonce be el.[[CryptographicNonce]].

9. Let integrity metadata be the value of el's integrity attribute, if it is specified, or the empty string otherwise.

10. If el does not have an integrity attribute, then set integrity metadata to the result of resolving a module integrity metadata with url and settings object.

11. Let referrer policy be the current state of el's referrerpolicy attribute.

12. Let fetch priority be the current state of el's fetchpriority attribute.

13. Let options be a script fetch options whose cryptographic nonce is cryptographic nonce, integrity metadata is integrity metadata, parser metadata is "not-parser-inserted", credentials mode is credentials mode, referrer policy is referrer policy, and fetch priority is fetch priority.

14. Fetch a modulepreload module script graph given url, destination, settings object, options, and with the following steps given result:

    1. If result is null, then fire an event named error at el, and return.

    2. Fire an event named load at el.

The process a link header steps for this type of linked resource are to do nothing.

このリンクのタイプをフェッチして処理する適切な時期は次のとおり：

• すでにブラウジングコンテキストに接続されているlink要素で外部リソースリンクが作成されたとき。

• 外部リソースリンクのlink要素がブラウジングコンテキストに接続されたとき。

• すでにブラウジングコンテキストに接続されている外部リソースリンクのlink要素のhref属性が変更されたとき。

• すでにブラウジングコンテキストに接続されている外部リソースリンクのlink要素のcrossorigin属性が設定、変更、または削除されたとき。

The fetch and process the linked resource steps for this type of linked resource, given a link element el, are to create link options from el and to preconnect given the result.

The process a link header step for this type of linked resource given a link processing options options are to preconnect given options.

To preconnect given a link processing options options:

1. If options's href is an empty string, return.

2. Let url be the result of encoding-parsing a URL given options's href, relative to options's base URL.

   Passing the base URL instead of a document or environment is tracked by issue #9715.

3. If url is failure, then return.

4. If url's scheme is not an HTTP(S) scheme, then return.

5. Let partitionKey be the result of determining the network partition key given options's environment.

6. Let useCredentials be true.

7. If options's crossorigin is Anonymous and options's origin does not have the same origin as url's origin, then set useCredentials to false.

8. The user agent should obtain a connection given partitionKey, url's origin, and useCredentials.

   この接続は取得されるが、直接使用されない。後で使用するために接続プールに残る。

   ユーザーエージェントは、可能な限りいつでも、事前接続を開始して完全接続ハンドシェイク（HTTPの場合はDNS+TCP、HTTPS生成元の場合はDNS+TCP+TLS）を実行しようとすべきであるが、部分ハンドシェイク（HTTPの場合はDNSのみ、HTTPS生成元の場合はDNSまたはDNS+TCP）を実行することを選択する、またはリソースの制約もしくはその他の理由により、完全にスキップできる。

   生成元ごとの最適な接続数は、ネゴシエートされたプロトコル、ユーザーの現在の接続プロファイル、使用可能なデバイスリソース、グローバル接続制限、およびその他のコンテキスト固有の変数に依存する。その結果、開くべき接続数の決定は、ユーザーエージェントに従う。

このリンクのタイプをフェッチして処理する適切な時期は次のとおり：

• すでにブラウジングコンテキストに接続されているlink要素で外部リソースリンクが作成されたとき。

• 外部リソースリンクのlink要素がブラウジングコンテキストに接続されたとき。

• すでにブラウジングコンテキストに接続されている外部リソースリンクのlink要素のhref属性が変更されたとき。

• すでにブラウジングコンテキストに接続されている外部リソースリンクのlink要素のcrossorigin属性が設定、変更、または削除されたとき。

The fetch and process the linked resource algorithm for prefetch links, given a link element el, is as follows:

1. If el's href attribute's value is the empty string, then return.

2. Let options be the result of creating link options from el.

3. Let request be the result of creating a link request given options.

4. If request is null, then return.

5. Set request's initiator to "prefetch".

6. Let processPrefetchResponse be the following steps given a response response and null, failure, or a byte sequence bytesOrNull:

   1. If response is a network error, fire an event named error at el.

   2. Otherwise, fire an event named load at el.

7. The user agent should fetch request, with processResponseConsumeBody set to processPrefetchResponse. User agents may delay the fetching of request to prioritize other requests that are necessary for the current document.

The process a link header steps for this type of linked resource are to do nothing.

このようなリンクのリンクされたリソースをフェッチして処理する適切な時期は次のとおり：

• すでにブラウジングコンテキストに接続されているlink要素で外部リソースリンクが作成されたとき。

• 外部リソースリンクのlink要素がブラウジングコンテキストに接続されたとき。

• すでにブラウジングコンテキストに接続されている外部リソースリンクのlink要素のhref属性が変更されたとき。

• すでにブラウジングコンテキストに接続されている外部リソースリンクのlink要素のas属性が変更されたとき。

• すでにブラウジングコンテキストに接続されているが、リクエストの宛先のサポートされていないタイプを指定しているtype属性のために以前に取得されなかった、外部リソースリンクのlink要素のtype属性が設定、削除、または変更されたとき。

• すでにブラウジングコンテキストに接続されているが、media属性が環境と一致しないために以前に取得されなかった外部リソースリンクのlink要素のmedia属性が変更または削除されたとき。

To consume a preloaded resource for Window window, given a URL url, a string destination, a string mode, a string credentialsMode, a string integrityMetadata, and onResponseAvailable, which is an algorithm accepting a response:

1. Let key be a preload key whose URL is url, destination is destination, mode is mode, and credentials mode is credentialsMode.

2. Let preloads be window's associated Document's map of preloaded resources.

3. If key does not exist in preloads, then return false.

4. Let entry be preloads[key].

5. Let consumerIntegrityMetadata be the result of parsing integrityMetadata.

6. Let preloadIntegrityMetadata be the result of parsing entry's integrity metadata.

7. If none of the following conditions apply:

   • consumerIntegrityMetadata is no metadata;

   • consumerIntegrityMetadata is equal to preloadIntegrityMetadata; or

     This comparison would ignore unknown integrity options. See issue #116.

   then return false.

   A mismatch in integrity metadata between the preload and the consumer, even if both match the data, would lead to an additional fetch from the network.

   It is important that network errors are added to the preload cache so that if a preload request results in an error, the erroneous response isn't re-requested from the network later. This also has security implications; consider the case where a developer specifies subresource integrity metadata on a preload request, but not the following resource request. If the preload request fails subresource integrity verification and is discarded, the resource request will fetch and consume a potentially-malicious response from the network without verifying its integrity. [SRI]

8. Remove preloads[key].

9. If entry's response is null, then set entry's on response available to onResponseAvailable.

10. Otherwise, call onResponseAvailable with entry's response.

11. Return true.

For the purposes of this section, a string type matches a preload destination destination if the following algorithm returns true:

1. If type is an empty string, then return true.

2. If destination is "fetch", then return true.

3. Let mimeTypeRecord be the result of parsing type.

4. If mimeTypeRecord is failure, then return false.

5. If mimeTypeRecord is not supported by the user agent, then return false.

6. If any of the following are true:

   • destination is "script" and mimeTypeRecord is a JavaScript MIME type;

   • destination is "image" and mimeTypeRecord is an image MIME type;

   • destination is "font" and mimeTypeRecord is a font MIME type;

   • destination is "style" and mimeTypeRecord's essence is text/css; or

   • destination is "track" and mimeTypeRecord's essence is text/vtt,

   then return true.

7. falseを返す。

To create a preload key for a request request, return a new preload key whose URL is request's URL, destination is request's destination, mode is request's mode, and credentials mode is request's credentials mode.

To translate a preload destination given a string destination:

1. If destination is not a preload destination, then return null.

2. Return the result of translating destination.

To preload given a link processing options options and an optional processResponse, which is an algorithm accepting a response:

1. If options's type doesn't match options's destination, then return.

2. If options's destination is "image" and options's source set is not null, then set options's href to the result of selecting an image source from options's source set.

3. Let request be the result of creating a link request given options.

4. If request is null, then return.

5. Let unsafeEndTime be 0.

6. Let entry be a new preload entry whose integrity metadata is options's integrity.

7. Let key be the result of creating a preload key given request.

8. If options's document is null, then set request's initiator type to "early hint".

9. Let controller be null.

10. Let reportTiming given a Document document be to report timing for controller given document's relevant global object.

11. Set controller to the result of fetching request, with processResponseConsumeBody set to the following steps given a response response and null, failure, or a byte sequence bodyBytes:

    1. If bodyBytes is a byte sequence, then set response's body to bodyBytes as a body.

       By using processResponseConsumeBody, we have extracted the entire body. This is necessary to ensure the preloader loads the entire body from the network, regardless of whether the preload will be consumed (which is uncertain at this point). This step then resets the request's body to a new body containing the same bytes, so that other specifications can read from it at the time of actual consumption, despite us having already done so once.

    2. Otherwise, set response to a network error.

    3. Set unsafeEndTime to the unsafe shared current time.

    4. If options's document is not null, then call reportTiming given options's document.

    5. If entry's on response available is null, then set entry's response to response; otherwise call entry's on response available given response.

    6. If processResponse is given, then call processResponse with response.

12. Let commit be the following steps given a Document document:

    1. If entry's response is not null, then call reportTiming given document.

    2. Set document's map of preloaded resources[key] to entry.

13. If options's document is null, then set options's on document ready to commit. Otherwise, call commit with options's document.

The fetch and process the linked resource steps for this type of linked resource, given a link element el, are:

1. Update the source set for el.

2. Let options be the result of creating link options from el.

3. Let destination be the result of translating the keyword representing the state of el's as attribute.

4. If destination is null, then return.

5. Set options's destination to destination.

6. Preload options, with the following steps given a response response:

   1. If response is a network error, fire an event named error at el. Otherwise, fire an event named load at el.

      The actual browsers' behavior is different from the spec here, and the feasibility of changing the behavior has not yet been investigated. See issue #1142.

The process a link header step for this type of link given a link processing options options is to preload options.

要素がノード文書のパーサーによって作成された場合、link要素は暗黙的に潜在的にレンダリングブロックキングである。

When the disabled attribute of a link element with a stylesheet keyword is set, disable the associated CSS style sheet.

このリンクのタイプをフェッチして処理する適切な時期は次のとおり：

• すでにブラウジングコンテキストに接続されているlink要素で外部リソースリンクが作成されたとき。

• 外部リソースリンクのlink要素がブラウジングコンテキストに接続されたとき。

• すでにブラウジングコンテキストに接続されている外部リソースリンクのlink要素のhref属性が変更されたとき。

• When the disabled attribute of the link element of an external resource link that is already browsing-context connected is set, changed, or removed.

• すでにブラウジングコンテキストに接続されている外部リソースリンクのlink要素のcrossorigin属性が設定、変更、または削除されたとき。

• When the type attribute of the link element of an external resource link that is already browsing-context connected is set or changed to a value that does not or no longer matches the Content-Type metadata of the previous obtained external resource, if any.

• When the type attribute of the link element of an external resource link that is already browsing-context connected, but was previously not obtained due to the type attribute specifying an unsupported type, is removed or changed.

• When the external resource link that is already browsing-context connected changes from being an alternative style sheet to not being one, or vice versa.

The linked resource fetch setup steps for this type of linked resource, given a link element el and request request, are:

1. If el's disabled attribute is set, then return false.

2. If el contributes a script-blocking style sheet, append el to its node document's script-blocking style sheet set.

3. If el's media attribute's value matches the environment and el is potentially render-blocking, then block rendering on el.

4. If el is currently render-blocking, then set request's render-blocking to true.

5. Return true.

To process this type of linked resource given a link element el, boolean success, response response, and byte sequence bodyBytes:

1. If the resource's Content-Type metadata is not text/css, then set success to false.

2. If el no longer creates an external resource link that contributes to the styling processing model, or if, since the resource in question was fetched, it has become appropriate to fetch it again:

   1. Remove el from el's node document's script-blocking style sheet set.

   2. Return.

3. If el has an associated CSS style sheet, remove the CSS style sheet.

4. If success is true:

   1. Create a CSS style sheet with the following properties:

      type

      text/css

      location

      response's URL list[0]

      We provide a URL here on the assumption that w3c/csswg-drafts issue #9316 will be fixed.

      owner node

      el

      media

      The media attribute of el.

      This is a reference to the (possibly absent at this time) attribute, rather than a copy of the attribute's current value. CSSOM defines what happens when the attribute is dynamically set, changed, or removed.

      title

      The title attribute of el, if el is in a document tree, or the empty string otherwise.

      This is similarly a reference to the attribute, rather than a copy of the attribute's current value.

      alternate flag

      Set if the link is an alternative style sheet and el's explicitly enabled is false; unset otherwise.

      origin-clean flag

      Set if the resource is CORS-same-origin; unset otherwise.

      parent CSS style sheet

      owner CSS rule

      null

      disabled flag

      Left at its default value.

      CSS rules

      Left uninitialized.

      This doesn't seem right. Presumably we should be using bodyBytes? Tracked as issue #2997.

      The CSS environment encoding is the result of running the following steps: [CSSSYNTAX]

      1. If el has a charset attribute, get an encoding from that attribute's value. If that succeeds, return the resulting encoding. [ENCODING]

      2. Otherwise, return the document's character encoding. [DOM]

   2. Fire an event named load at el.

5. Otherwise, fire an event named error at el.

6. If el contributes a script-blocking style sheet:

   1. Assert: el's node document's script-blocking style sheet set contains el.

   2. Remove el from its node document's script-blocking style sheet set.

7. Unblock rendering on el.

The process a link header steps for this type of linked resource are to do nothing.