From 153e432344527f089e3fd85c477fcb3906f86026 Mon Sep 17 00:00:00 2001 From: Josh Karlin Date: Wed, 3 Jan 2024 14:59:36 +0000 Subject: [PATCH] Merge pull request #276 from patcg-individual-drafts/yao-return-empty-topics-on-user-setting-failure SHA: 73f85fa89a9d1347c5ce477295e3ad79c8afb40d Reason: push, by jkarlin Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- index.html | 1753 +++++++++++++++++++++++++++++++++------------------- 1 file changed, 1125 insertions(+), 628 deletions(-) diff --git a/index.html b/index.html index c5d87e4..e3ac020 100644 --- a/index.html +++ b/index.html @@ -5,9 +5,9 @@ Topics API - + - + - + - + -

Topics API

-

Unofficial Proposal Draft,

+

Unofficial Proposal Draft,

More details about this document
@@ -695,7 +740,7 @@

Topics API

-

Copyright © 2023 the Contributors to “Topics API”. +

Copyright © 2024 the Contributors to “Topics API”. This document is licensed under the W3C Software License. @@ -1311,7 +1356,7 @@

partial interface Document { - [SecureContext] Promise<sequence<BrowsingTopic>> browsingTopics(optional BrowsingTopicsOptions options = {}); + [SecureContext] Promise<sequence<BrowsingTopic>> browsingTopics(optional BrowsingTopicsOptions options = {}); };
@@ -1346,12 +1391,7 @@

document is not allowed to use the browsing-topics feature.

  • document is not allowed to use the interest-cohort feature.

    -
  • -

    The user preference setting disallows access to topics from topLevelDocument given document’s origin.

    -
  • -

    Access to topics from topLevelDocument given document’s origin is disabled due to some other user agent-defined mechanism, like lack of enrollment.

    -

    Note: In Chrome’s experimentation phase, it will additionally require a valid origin trial token to exist in document.

    then:

    1. @@ -1363,14 +1403,20 @@

      Run the following steps in parallel:

      1. -

        Let topics be the result of running the calculate the topics for caller algorithm, with topicsCallerContext as input.

        +

        Let topics be an empty list.

      2. -

        If options["skipObservation"] is false:

        +

        If the user preference setting and other user agent-defined mechanisms like enrollment allow access to topics from topLevelDocument given document’s origin:

        1. -

          Run the collect page topics calculation input data algorithm with topLevelDocument as input.

          +

          Set topics to the result of running the calculate the topics for caller algorithm, with topicsCallerContext as input.

        2. -

          Run the collect topics caller domain algorithm with topLevelDocument and topicsCallerContext’s caller domain as input.

          +

          If options["skipObservation"] is false:

          +
            +
          1. +

            Run the collect page topics calculation input data algorithm with topLevelDocument as input.

            +
          2. +

            Run the collect topics caller domain algorithm with topLevelDocument and topicsCallerContext’s caller domain as input.

            +

      3. Queue a global task on the browsing topics task source given document’s relevant global object to perform the following steps:

        @@ -1460,7 +1506,7 @@

        caller domain to requestOrigin’s host's registrable domain.

      4. -

        Set topicsCallerContext’s top level context domain to topLevelDocument’s origin's host's registrable domain.

        +

        Set topicsCallerContext’s top level context domain to topLevelDocument’s origin's host's registrable domain.

      5. Let unsafeMoment be the wall clock's unsafe current time.

      6. @@ -1470,11 +1516,17 @@

        timestamp to fromUnixEpochTime.

      7. -

        If the user preference setting disallows access to topics from topLevelDocument given requestOrigin, or access to topics from topLevelDocument given requestOrigin is disabled due to some other user agent-defined mechanism, like lack of enrollment, then return.

        +

        Let topics be an empty list.

      8. -

        Let topics be the result of running the calculate the topics for caller algorithm, with topicsCallerContext as input.

        +

        Let numVersionsInEpochs be 0.

      9. -

        Let numVersionsInEpochs be the result of running the get the number of distinct versions in epochs algorithm, with topicsCallerContext as input.

        +

        If the user preference setting and other user agent-defined mechanisms like enrollment allow access to topics from topLevelDocument given requestOrigin:

        +
          +
        1. +

          Set topics to the result of running the calculate the topics for caller algorithm, with topicsCallerContext as input.

          +
        2. +

          Set numVersionsInEpochs to the result of running the get the number of distinct versions in epochs algorithm, with topicsCallerContext as input.

          +

      10. Let versionsToTopics be an ordered map.

      11. @@ -1584,7 +1636,6 @@

        topic ids are < 10, < 100, etc.)

        The various lengths being returned (that depends on the number of distinct versions) could leak which epochs the user had disabled topics or didn’t use the browser, if it coincided with the version change. But this leak is minor. The most common cases (i.e. returning same version topics, or no topics) will have the same length.

    • -
    In Chrome’s experimentation phase, it will additionally require a valid origin trial token to exist in initiatorWindow’s associated document for the request to be eligible for topics.

    15.9. The `Observe-Browsing-Topics` HTTP response header

    The `Observe-Browsing-Topics` HTTP response header can be used to record a caller’s topics observation.

    @@ -1596,7 +1647,11 @@

    window's global object's navigable's top-level traversable's active document.

  • -

    Let callerDomain be request’s current URL's origin's host's registrable domain.

    +

    Let callerOrigin be request’s current URL's origin.

    +
  • +

    If the user preference setting or other user agent-defined mechanisms like enrollment disallows access to topics from topLevelDocument given callerOrigin, then return.

    +
  • +

    Let callerDomain be callerOrigin’s host's registrable domain.

  • Let list be response’s header list.

  • @@ -1824,7 +1879,6 @@

    HTMLIFrameElement
  • active document
  • allowed to use -
  • associated document
  • container
  • content attributes
  • environment settings object @@ -1949,468 +2003,8 @@

    I }; - - - + - + + \ No newline at end of file