discovery-api/Overview.src.html
author Rich Tibbett <richt@opera.com>
Mon, 03 Sep 2012 15:35:05 +0200
changeset 215 53f4bfeee4fe
child 216 5583626294f6
permissions -rw-r--r--
Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
215
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
     1
<!DOCTYPE html>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
     2
<html>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
     3
  <head>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
     4
    <title>Networked Service Discovery and Messaging</title>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
     5
    <meta http-equiv='Content-Type' content='text/html;charset=utf-8'/>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
     6
    <script type="text/javascript" class='remove'>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
     7
      var respecConfig = {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
     8
          specStatus:   "ED",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
     9
          //publishDate:  "2012-08-22",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    10
          shortName:    "discovery-api",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    11
          edDraftURI:   "http://w3c-test.org/dap/discovery-api/",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    12
          previousMaturity: "WD",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    13
          previousPublishDate: "2012-08-07",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    14
          editors: [
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    15
            {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    16
              name:       "Rich Tibbett",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    17
              //url:        "http://richt.me/",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    18
              company:    "Opera Software ASA",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    19
              companyURL: "http://opera.com/"
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    20
            },
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    21
            {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    22
              name:       "Clarke Stevens",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    23
              //url:      "",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    24
              company:    "CableLabs",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    25
              companyURL: "http://cablelabs.com/"
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    26
            }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    27
          ],
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    28
          noIDLIn:      true,
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    29
          wg:           "Device APIs and Policy Working Group",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    30
          wgURI:        "http://www.w3.org/2009/dap/",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    31
          wgPublicList: "public-device-apis",
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    32
          wgPatentURI:  "http://www.w3.org/2004/01/pp-impl/43696/status"
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    33
      };
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    34
    </script>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    35
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    36
    <script src='http://www.w3.org/Tools/respec/respec-w3c-common' type="text/javascript" class='remove' async></script>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    37
    <style type="text/css">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    38
      /* Custom CSS optimizations (Richard Tibbett) */
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    39
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    40
      /* Add better spacing to sections */
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    41
      section, .section { margin-bottom: 2em; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    42
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    43
      /* Reduce note & issue render size */
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    44
      .note, .issue { font-size:0.8em; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    45
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    46
      /* Add addition spacing to <ol> and <ul> for rule definition */
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    47
      ol.rule li, ul.rule li { padding:0.6em; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    48
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    49
      pre.widl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    50
      pre.widl :link, pre.widl :visited { color: #000; background: transparent; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    51
      pre.widl:before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    52
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    53
      div.example { border: solid thin red; background: #F7DFE5; color: black; padding: 0.5em 1em; position: relative; margin: 1em 0 1em 4.6em; width: auto; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    54
      div.example:before { content: "EXAMPLE"; font: bold small sans-serif; padding: 0.5em; background: red; color: white; position: absolute; top: 0; margin: -1px 0 0 -7.6em; width: 5em; border: thin solid red; border-radius: 0 0 0 0.5em }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    55
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    56
      dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    57
      hr + dl.domintro, div.impl + dl.domintro { margin-top: 2.5em; margin-bottom: 1.5em; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    58
      dl.domintro dt, dl.domintro dt * { color: black; text-decoration: none; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    59
      dl.domintro dd { margin: 0.5em 0 1em 2em; padding: 0; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    60
      dl.domintro dd p { margin: 0.5em 0; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    61
      dl.domintro code {font-size: inherit; font-style: italic; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    62
      dl.domintro:before { display: table; margin: -1em -0.5em 0.5em auto; width: auto; content: 'This box is non-normative. Implementation requirements are given below this box.'; color: red; border: solid 2px; background: white; padding: 0 0.25em; }
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    63
    </style>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    64
  </head>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    65
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    66
  <body>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    67
    <section id='abstract'>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    68
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    69
        This specification defines a mechanism for an HTML document to discover and subsequently communicate with <abbr title="Hypertext Transfer Protocol">HTTP</abbr>-based services
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    70
        advertised via common discovery protocols within a user's network.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    71
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    72
    </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    73
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    74
    <section id='sotd'>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    75
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    76
        This document represents the early consensus of the group on the scope and features of the proposed
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    77
        API.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    78
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    79
    </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    80
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    81
    <section class="informative">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    82
      <h3>Introduction</h3>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    83
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    84
      <p>To enable Web pages to connect and communicate with Local-networked Services provided over HTTP, this specification introduces the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    85
      <a href="#navigatornetworkservice"><code>NavigatorNetworkService</code></a> interface.</p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    86
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    87
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    88
         Using this <abbr title="Application Programming Interface">API</abbr> consists of requesting a well-known service type, known by developers and advertised by Local-networked Devices. User authorization, where the user connects the web page to one or more discovered services,
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    89
         is expected before the web page is able to interact with any Local-networked Services.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    90
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    91
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    92
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    93
         A web page creates a request to obtain connectivity to services running in the network by specifying a well-known discovery service type that it wishes to interact with.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    94
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    95
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    96
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    97
         The user agent, having captured all advertised services on the network from the Service Discovery mechanisms included in this recommendation, attempts to match
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    98
      the requested service type to a discovered service according to the processing described herein.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
    99
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   100
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   101
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   102
          If a service connectivity request is successful then the Web page is provided with the necessary information to communicate with the authorized Local-networked Service.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   103
          If the request fails then the Web page will receive an error callback containing an error code describing the cause of Local-networked Service connectivity failure.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   104
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   105
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   106
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   107
         Once connected to a Local-networked Service the Web page can send requests and receive responses to the Local-networked Service via the messaging format and appropriate channel inferred from the service type
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   108
         authorized via the provided API.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   109
         The Web page, once connected, can also receive service-pushed events, in the messaging format supported by the Local-networked Device, if such event subscription functionality is provided by the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   110
         connected Local-networked Service.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   111
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   112
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   113
      <div class="example">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   114
       <p>Example of requesting a DNS-SD advertised service:</p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   115
       <hr />
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   116
       <pre class="highlight">function showServices( services ) {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   117
  // Show a list of all the services provided to the web page
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   118
  for(var i = 0, l = services.length; i < l; i++) console.log( services[i].name );
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   119
}
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   120
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   121
navigator.getNetworkServices('zeroconf:_boxee-jsonrpc._tcp', showServices);</pre>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   122
      </div>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   123
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   124
      <div class="example">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   125
        <p>Example of requesting a UPnP advertised service, also handling error conditions:</p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   126
        <hr />
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   127
        <pre class="highlight">function showServices( services ) {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   128
  // Show a list of all the services provided to the web page
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   129
  for(var i = 0, l = services.length; i < l; i++) console.log( services[i].name );
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   130
}
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   131
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   132
function error( e ) {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   133
  console.log( "Error occurred: " + e.code );
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   134
}
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   135
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   136
navigator.getNetworkServices('upnp:urn:schemas-upnp-org:service:ContentDirectory:1', showServices, error);</pre>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   137
      </div>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   138
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   139
      <div class="example">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   140
        <p>Example of requesting either a DNS-SD or UPnP advertised service:</p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   141
        <hr />
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   142
        <pre class="highlight">function showServices( services ) {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   143
  // Show a list of all the services provided to the web page (+ service type)
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   144
  for(var i = 0, l = services.length; i < l; i++)
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   145
     console.log( services[i].name + '(' + services[i].type + ')' );
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   146
}
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   147
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   148
navigator.getNetworkServices([
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   149
  'zeroconf:_boxee-jsonrpc._tcp',
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   150
  'upnp:urn:schemas-upnp-org:service:ContentDirectory:1'
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   151
], showServices);</pre>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   152
      </div>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   153
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   154
      <p>For more detailed examples see the <a href="#examples">Examples</a> section.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   155
    </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   156
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   157
    <section
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   158
     id='conformance'>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   159
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   160
     <p>Requirements phrased in the imperative as part of algorithms (such as "strip any leading space characters" or "return false and abort these steps") are to be interpreted with the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   161
     meaning of the key word ("must", "should", "may", etc) used in introducing the algorithm.</p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   162
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   163
     <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   164
      Some conformance requirements are phrased as requirements on attributes, methods or objects. Such requirements are to be interpreted as requirements on user agents.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   165
     </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   166
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   167
     <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   168
      Conformance requirements phrased as algorithms or specific steps may be implemented in any manner, so long as the end result is equivalent. (In particular, the algorithms defined in
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   169
      this specification are intended to be easy to follow, and not intended to be performant.)
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   170
     </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   171
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   172
     <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   173
      The only conformance class defined by this specification is a <dfn>user agent</dfn>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   174
     </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   175
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   176
     <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   177
      User agents may impose implementation-specific limits on otherwise unconstrained inputs, e.g. to prevent denial of service attacks, to guard against running out of memory, or to work
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   178
      around platform-specific limitations.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   179
     </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   180
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   181
     <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   182
      When support for a feature is disabled (e.g. as an emergency measure to mitigate a security problem, or to aid in development, or for performance reasons), user agents must act as if
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   183
      they had no support for the feature whatsoever, and as if the feature was not mentioned in this specification. For example, if a particular feature is accessed via an attribute in a Web
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   184
      IDL interface, the attribute itself would be omitted from the objects that implement that interface - leaving the attribute on the object but making it return null or throw an exception
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   185
      is insufficient.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   186
     </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   187
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   188
      <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   189
         <h3>Dependencies</h3>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   190
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   191
         This specification relies on several other underlying specifications.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   192
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   193
         <dl>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   194
            <dt>HTML</dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   195
            <dd>Many fundamental concepts from HTML are used by this specification. [[!HTML5]]</dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   196
            <dt>WebIDL</dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   197
            <dd>The IDL blocks in this specification use the semantics of the WebIDL specification. [[!WEBIDL]]</dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   198
         </dl>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   199
      </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   200
    </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   201
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   202
    <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   203
      <h3>Terminology</h3>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   204
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   205
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   206
         The construction "a <code>Foo</code> object", where <code>Foo</code> is actually an interface, is sometimes used instead of the more accurate "an object implementing the interface <code>Foo</code>".
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   207
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   208
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   209
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   210
         The term DOM is used to refer to the API set made available to scripts in Web applications, and does not necessarily imply the existence of an actual <code>Document</code> object or of any
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   211
         other <code>Node</code> objects as defined in the DOM Core specifications. [[!DOM4]]
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   212
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   213
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   214
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   215
         An IDL attribute is said to be <em>getting</em> when its value is being retrieved (e.g. by author script), and is said to be <em>setting</em> when a new value is assigned to it.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   216
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   217
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   218
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   219
        A <dfn>valid service type</dfn> is a string that begins with <code>upnp:</code> or <code>zeroconf:</code> followed by one or more characters in the ranges U+0021, U+0023 to U+0027, U+002A to U+002B, U+002D to U+002E, U+0030 to U+0039, U+0041 to U+005A, U+005E to U+007E.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   220
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   221
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   222
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   223
        A <a>valid service type</a> provided in the <code>type</code> attribute of the <code>getNetworkServices()</code> method will be matched against the services currently contained in the <a>list of available service records</a> according to the algorithms defined in this specification.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   224
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   225
    </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   226
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   227
    <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   228
     <h2>Requesting networked services</h2>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   229
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   230
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   231
<pre class="widl">[Supplemental, NoInterfaceObject]
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   232
interface <dfn id="navigatornetworkservice">NavigatorNetworkService</dfn> {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   233
  // Obtain a Local-networked Service
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   234
  void <a href="#dom-navigator-getnetworkservices">getNetworkServices</a>( in any type,
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   235
                           in <a href="#navigatornetworkservicesuccesscallback">NavigatorNetworkServiceSuccessCallback</a> successCallback,
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   236
                           in optional <a href="#navigatornetworkserviceerrorcallback">NavigatorNetworkServiceErrorCallback</a> errorCallback );
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   237
};
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   238
<a class="externalDFN" href="http://www.whatwg.org/specs/web-apps/current-work/complete/timers.html#navigator">Navigator</a> implements <a href="#navigatornetworkservice">NavigatorNetworkService</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   239
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   240
[Callback=FunctionOnly, NoInterfaceObject]
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   241
interface <dfn id="navigatornetworkservicesuccesscallback">NavigatorNetworkServiceSuccessCallback</dfn> {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   242
  void handleEvent( in <a href="#networkservices">NetworkServices</a> services );
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   243
};
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   244
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   245
[NoInterfaceObject]
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   246
interface <dfn id="navigatornetworkserviceerror">NavigatorNetworkServiceError</dfn> {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   247
  const unsigned short <a href="#dom-navigatornetworkserviceerror-permission_denied">PERMISSION_DENIED_ERR</a> = 1;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   248
  const unsigned short <a href="#dom-navigatornetworkserviceerror-unknown_type_prefix">UNKNOWN_TYPE_PREFIX_ERR</a> = 2;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   249
  readonly attribute unsigned short <a href="#dom-navigatornetworkserviceerror-code">code</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   250
};
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   251
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   252
[Callback=FunctionOnly, NoInterfaceObject]
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   253
interface <dfn id="navigatornetworkserviceerrorcallback">NavigatorNetworkServiceErrorCallback</dfn> {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   254
  void handleEvent( in <a href="#navigatornetworkserviceerror">NavigatorNetworkServiceError</a> error );
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   255
};
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   256
</pre>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   257
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   258
  <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   259
   <h2>Methods</h2>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   260
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   261
      <dl class="domintro">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   262
        <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   263
          <var title="">window</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   264
           .
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   265
          <code title="dom-navigator">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   266
            <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/timers.html#navigator">navigator</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   267
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   268
           .
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   269
          <code title="dom-navigator-getNetworkServices">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   270
            <a href="#dom-navigator-getnetworkservices">getNetworkServices</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   271
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   272
          (
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   273
          <var title="">type</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   274
          ,
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   275
          <var title="">successCallback</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   276
           [,
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   277
          <var title="">errorCallback</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   278
           ] )
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   279
        </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   280
        <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   281
          <p>Prompts the user to select one or more discovered network services that have advertised support for the requested service type.</p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   282
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   283
            The
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   284
            <var title="">type</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   285
             argument contains one or more <a>valid service type</a> tokens that the web page would like to interact with.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   286
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   287
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   288
            If the user accepts, the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   289
            <var title="">successCallback</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   290
             is
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   291
          invoked, with one or more
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   292
            <code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   293
              <a href="#networkservice"><code>NetworkService</code></a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   294
            </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   295
             objects as
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   296
          its argument.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   297
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   298
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   299
            If the user declines, the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   300
            <var title="">errorCallback</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   301
             (if
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   302
          any) is invoked.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   303
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   304
        </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   305
      </dl>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   306
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   307
       <div>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   308
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   309
            When the <dfn id="dom-navigator-getnetworkservices" title="dom-navigator-getnetworkservices"><code>getNetworkServices(type, successCallback[, errorCallback])</code></dfn> method is called, the <a>user agent</a> MUST run the following steps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   310
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   311
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   312
          <ol class="rule">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   313
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   314
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   315
              Let <var>requested control types</var> be initially set to an empty array.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   316
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   317
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   318
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   319
               If <var>type</var> is an array consisting of one or more <a>valid service type</a> tokens, then let <var>requested control types</var> by the value of <var>type</var>, removing any non-<a>valid service type</a> tokens from the resulting array.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   320
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   321
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   322
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   323
               If <var>type</var> is a string consisting of one <a>valid service type</a> token, then let <var>requested control types</var> be an array containing one item with a value of <var>type</var>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   324
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   325
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   326
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   327
               If <var>requested control types</var> is an array that contains at least one or more <a title="valid service type">valid service type</a> tokens then continue to the step labeled <em>process</em> below. Otherwise, the <a>user agent</a> MUST <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">queue a task</a> to invoke <var>errorCallback</var>, if it is provided and is an object of type <code>Function</code>, with a new <a href="#navigatornetworkserviceerror"><code>NavigatorNetworkServiceError</code></a> object whose
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   328
                 <a href="#dom-navigatornetworkserviceerror-code"><code>code</code></a> attribute has the numeric value 2
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   329
                  (<a href="#dom-navigatornetworkserviceerror-unknown_type_prefix"><code>UNKNOWN_TYPE_PREFIX_ERR</code></a>) as its argument,
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   330
                   abort any remaining steps and return.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   331
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   332
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   333
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   334
               <em>Process</em>: Let <var>services found</var> be an empty array.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   335
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   336
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   337
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   338
               For each <var>available service</var> in the <a>list of available service records</a> run the following steps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   339
               <ol class="rule">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   340
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   341
                    For each <var>requested control type</var> in <var>requested control types</var>: If <var>available service</var>'s <code>type</code> attribute equals the <var>requested control type</var> then let <var>matched service</var> equal the value of <var>available service</var> and continue at the step labeled <var>attach</var> below.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   342
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   343
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   344
                     Continue at the next <var>available service</var>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   345
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   346
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   347
                     <em>Attach</em>: If <var>matched service</var> is not empty then run the following steps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   348
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   349
                     <ol class="rule">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   350
                        <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   351
                           Let <var>new service object</var> be a new <a href="#networkservice"><code>NetworkService</code></a> object, mapping the parameters of
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   352
                     <var>matched service</var> to this new object where possible.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   353
                        </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   354
                        <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   355
                           Append <var>new service object</var> to the <var>services found</var> array.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   356
                        </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   357
                     </ol>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   358
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   359
               </ol>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   360
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   361
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   362
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   363
               If <var>services found</var> is an empty array, then the <a>user agent</a> MUST <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">queue a task</a> to invoke <var>errorCallback</var>, if it is provided and is an object of type <code>Function</code>, with a new <a href="#navigatornetworkserviceerror"><code>NavigatorNetworkServiceError</code></a> object whose
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   364
                 <a href="#dom-navigatornetworkserviceerror-code"><code>code</code></a> attribute has the numeric value 1
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   365
                 (<a href="#dom-navigatornetworkserviceerror-permission_denied"><code>PERMISSION_DENIED_ERR</code></a>) as its argument, abort any remaining steps and return.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   366
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   367
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   368
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   369
               Return, and run the remaining steps asynchronously.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   370
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   371
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   372
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   373
               Optionally, e.g. based on a previously-established user preference, for security reasons, or due to platform limitations, the <a>user agent</a> MAY <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">queue a task</a> to invoke <var>errorCallback</var>, if it is provided and is an object of type <code>Function</code>, with a new <a href="#navigatornetworkserviceerror"><code>NavigatorNetworkServiceError</code></a> object whose
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   374
                 <a href="#dom-navigatornetworkserviceerror-code"><code>code</code></a> attribute has the numeric value 1
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   375
                 (<a href="#dom-navigatornetworkserviceerror-permission_denied"><code>PERMISSION_DENIED_ERR</code></a>) as its argument, abort any remaining steps and return.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   376
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   377
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   378
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   379
                  The <a>user agent</a> MUST prompt the user in a user-agent-specific manner for permission to provide the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   380
                  <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/browsers.html#entry-script" class="externalDFN">entry script</a>'s
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   381
                  <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/origin-0.html#origin" class="externalDFN">origin</a> with an array of
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   382
                  <a href="#networkservice"><code>NetworkService</code></a> objects representing the user-authorized subset of <var>services found</var>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   383
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   384
               <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   385
                  If the user grants permission to access one or more networked services then the <a>user agent</a> SHOULD include an
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   386
                  "ongoing local-network communication" indicator.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   387
               </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   388
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   389
               <p>If the user denies permission, then the <a>user agent</a> MUST <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">queue a task</a> to invoke <var>errorCallback</var>, if it is provided and is an object of type <code>Function</code>, with a new <a href="#navigatornetworkserviceerror"><code>NavigatorNetworkServiceError</code></a> object whose
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   390
                <a href="#dom-navigatornetworkserviceerror-code"><code>code</code></a> attribute has the numeric value 1
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   391
                (<a href="#dom-navigatornetworkserviceerror-permission_denied"><code>PERMISSION_DENIED_ERR</code></a>) as its argument, abort any remaining steps and return.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   392
              </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   393
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   394
              <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   395
                If the user never responds, this algorithm stalls on this step.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   396
              </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   397
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   398
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   399
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   400
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   401
               Let <var>services</var> be the array of one or more <a href="#networkservice"><code>NetworkService</code></a> objects for which the user granted permission.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   402
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   403
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   404
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   405
               For each Object <var>service</var> in <var>services</var>, run the following substeps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   406
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   407
               <ol class="rule">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   408
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   409
                     Add the <var>service</var>'s <code>url</code> parameter to the <a>entry script origin's <abbr title="Uniform Resource Locator">URL</abbr> whitelist</a>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   410
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   411
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   412
                    If <var>service</var>'s <code>type</code> parameter begins with the DOMString &quot;<code>upnp:</code>&quot; and the <var>service</var>'s <code>eventsUrl</code> parameter is not empty then <a>setup a UPnP Events Subscription</a> for <var>service</var>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   413
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   414
               </ol>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   415
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   416
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   417
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   418
               Let <var>services manager</var> be a new <a href="#networkservices"><code>NetworkServices</code></a> object.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   419
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   420
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   421
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   422
               Set <var>services manager</var>'s <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute to the length of <var>services</var>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   423
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   424
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   425
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   426
              Store the set of <var>services</var> as <dfn id="current_authorized_services">current authorized services</dfn> internally against the newly created <var>services manager</var> object.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   427
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   428
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   429
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   430
               The <a>user agent</a> MUST <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">queue a task</a> to invoke <var>successCallback</var> with
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   431
               <var>services manager</var> as its argument.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   432
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   433
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   434
          </ol>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   435
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   436
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   437
            The <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#task-source" class="externalDFN">task source</a> for these
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   438
            <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#concept-task" class="externalDFN">tasks</a> is the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   439
            <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#user-interaction-task-source" class="externalDFN">user interaction task source</a>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   440
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   441
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   442
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   443
            When a <a href="#networkservice"><code>NetworkService</code></a> object is provided to a Web page, the <a>user agent</a> MUST add the <code>url</code> property
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   444
             to the <dfn>entry script origin's URL whitelist</dfn>. This list enables the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   445
            Web page to override and initiate cross-site resource requests towards these URLs, and any sub-resources of these URLs, within the current
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   446
            <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/browsers.html#entry-script" class="externalDFN">entry script</a>'s
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   447
            <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/origin-0.html#origin" class="externalDFN">origin</a> via various existing mechanisms (e.g. Web Sockets, Server-Sent Events,
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   448
            Web Messaging, XMLHttpRequest).
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   449
         </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   450
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   451
         <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   452
            If the user navigates away from the current browsing context, the <a>user agent</a> MUST remove all previously whitelisted urls from the <a>entry script origin's URL whitelist</a>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   453
            There is no persistence to network service selections provided to a web page. It is not possible to access a previously white-listed networked service without the necessary user authorization in all of the following cases:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   454
            <ul>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   455
              <li>If the current script is reloaded at any point in the same or different window.</li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   456
              <li>if the current script reinvokes the <a href="#dom-navigator-getnetworkservices"><code>getNetworkServices()</code></a> method at any point in its execution.</li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   457
              <li>If the user navigates forward or back in their history to reload the current page.</li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   458
              <li>If a script is running in a different origin.</li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   459
            </ul>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   460
         </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   461
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   462
      </div>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   463
      </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   464
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   465
      <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   466
         <h3>Error Handling</h3>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   467
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   468
      <dl class="domintro">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   469
        <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   470
          <var title="">error</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   471
           .
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   472
          <code title="dom-NavigatorNetworkServiceError-code">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   473
            <a href="#dom-navigatornetworkserviceerror-code">code</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   474
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   475
        </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   476
        <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   477
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   478
            Returns the current error's error code. At the current time, this may be <code>1</code> or <code>2</code>, for which the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   479
            corresponding error constants
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   480
            <a href="#dom-navigatornetworkserviceerror-permission_denied"><code>PERMISSION_DENIED_ERR</code></a> and
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   481
            <a href="#dom-navigatornetworkserviceerror-unknown_type_prefix"><code>UNKNOWN_TYPE_PREFIX_ERR</code></a> are defined.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   482
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   483
        </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   484
      </dl>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   485
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   486
         <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   487
            The <dfn id="dom-navigatornetworkserviceerror-code" title="dom-navigatornetworkserviceerror-code"><code>code</code></dfn> attribute of a
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   488
            <a href="#navigatornetworkserviceerror"><code>NavigatorNetworkServiceError</code></a> object MUST return the code for the error, which will be one of the following:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   489
         </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   490
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   491
         <dl>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   492
            <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   493
               <dfn id="dom-navigatornetworkserviceerror-permission_denied" title="dom-navigatornetworkserviceerror-permission_denied"><code>PERMISSION_DENIED_ERR</code></dfn> (numeric value 1)
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   494
            </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   495
            <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   496
               The user or user agent denied the page permission to access any services.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   497
            </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   498
            <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   499
               <dfn id="dom-navigatornetworkserviceerror-unknown_type_prefix" title="dom-navigatornetworkserviceerror-unknown_type_prefix"><code>UNKNOWN_TYPE_PREFIX_ERR</code></dfn> (numeric value 2)
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   500
            </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   501
            <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   502
               No <a>valid service type</a> tokens were provided in the method invocation.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   503
            </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   504
         </dl>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   505
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   506
      </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   507
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   508
      </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   509
      <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   510
      <h2>Obtaining networked services</h2>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   511
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   512
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   513
         The <a href="#networkservices"><code>NetworkServices</code></a> interface is the top-level response object from a call to <a href="#dom-navigator-getnetworkservices"><code>getNetworkServices()</code></a> and provides access to a set of user-authorized <a href="#networkservice"><code>NetworkService</code></a> objects for the given request.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   514
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   515
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   516
<pre class="widl">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   517
[NoInterfaceObject]
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   518
interface <dfn id="networkservices">NetworkServices</dfn> {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   519
  readonly attribute unsigned long    <a href="#dom-networkservices-length">length</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   520
  getter <a href="#networkservice">NetworkService</a> (unsigned long index);
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   521
  <a href="#networkservice">NetworkService</a>? <a href="#dom-networkservices-getservicebyid">getServiceById</a>(DOMString id);
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   522
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   523
  readonly attribute unsigned long    <a href="#dom-networkservices-servicesavailable">servicesAvailable</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   524
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   525
  // event handler attributes
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   526
           attribute <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#eventhandler" class="externalDFN">EventHandler</a>     <a href="#dom-networkservices-onserviceavailable">onserviceavailable</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   527
           attribute <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#eventhandler" class="externalDFN">EventHandler</a>     <a href="#dom-networkservices-onserviceunavailable">onserviceunavailable</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   528
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   529
};
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   530
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   531
<a href="#networkservices">NetworkServices</a> implements <a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#interface-eventtarget" class="externalDFN">EventTarget</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   532
</pre>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   533
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   534
      <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   535
      <h2>Attributes</h2>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   536
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   537
        <dl class="domintro">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   538
          <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   539
            <code title="dom-networkservices-length">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   540
              <a href="#dom-networkservices-length">length</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   541
            </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   542
          </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   543
          <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   544
            <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   545
              Returns the current number of services in the respective object's <a>current authorized services</a>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   546
            </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   547
          </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   548
          <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   549
            <code title="dom-networkservices-servicesavailable">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   550
              <a href="#dom-networkservices-servicesavailable">servicesAvailable</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   551
            </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   552
          </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   553
          <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   554
            <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   555
              Returns the current number of services matching one of the app-requested <a>valid service type</a> tokens that are actively available within the user's current network.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   556
            </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   557
          </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   558
        </dl>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   559
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   560
        <div>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   561
           <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   562
              The <dfn id="dom-networkservices-length"><code>length</code></dfn> attribute MUST return the number of services represented in the object's corresponding <a>current authorized services</a> list at the time of getting.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   563
           </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   564
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   565
           <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   566
              The <dfn id="dom-networkservices-servicesavailable"><code>servicesAvailable</code></dfn> attribute MUST return the number of services available in the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   567
              user's network that match the <a>valid service type</a> that was initially used to create the current <a href="#networkservices"><code>NetworkServices</code></a> object.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   568
           </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   569
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   570
           <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   571
             When a previously unknown instance of a networked service matching one of the requested <a href="#dfn-valid-service-type">valid service types</a> becomes available on the user's current network, the <a>user agent</a> MUST increment the <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute by <code>1</code> and then
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   572
             <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">queue a task</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   573
             to dispatch a newly created event with the name <code>serviceavailable</code> that uses the <code>Event</code> interface, which does
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   574
             not bubble, is not cancellable, and has no default action, at the current <a href="#networkservices"><code>NetworkServices</code></a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   575
             object.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   576
           </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   577
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   578
           <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   579
             When a previously known instance of a networked service matching one of the requested <a href="#dfn-valid-service-type">valid service types</a> becomes unavailable on the user's current network, the <a>user agent</a> MUST decrement the <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute by <code>1</code> and then
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   580
             <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">queue a task</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   581
              to dispatch a newly created event with the name <code>serviceunavailable</code> that uses the <code>Event</code> interface, which does
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   582
              not bubble, is not cancellable, and has no default action, at the current <a href="#networkservices"><code>NetworkServices</code></a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   583
              object.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   584
           </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   585
        </div>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   586
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   587
      </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   588
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   589
      <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   590
      <h2>Methods</h2>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   591
        <dl class="domintro">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   592
        <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   593
          <code title="networkservices-getter">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   594
            <a href="#networkservices">services</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   595
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   596
          [
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   597
          <var title="">index</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   598
          ]
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   599
        </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   600
        <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   601
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   602
            Returns the specified <a href="#networkservice"><code>NetworkService</code></a> object.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   603
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   604
        </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   605
        <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   606
          <code title="networkservices-getter">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   607
            <a href="#networkservices">services</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   608
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   609
          .
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   610
          <code title="dom-networkservices-getservicebyid">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   611
            <a href="#dom-networkservices-getservicebyid">getServiceById</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   612
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   613
          (
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   614
          <var title="">id</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   615
          )
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   616
        </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   617
        <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   618
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   619
            Returns the <a href="#networkservice"><code>NetworkService</code></a> object with the given identifier, or null if no
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   620
            service has that identifier.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   621
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   622
        </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   623
      </dl>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   624
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   625
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   626
        A <a href="#networkservices"><code>NetworkServices</code></a> object represents the current list of zero or more <a>current authorized services</a>, of which zero or more can be available at a time. Each item in <a>current authorized services</a> is represented by a <a href="#networkservice"><code>NetworkService</code></a> object. The list of <a>current authorized services</a> is <span>immutable</span> meaning that it cannot be modified for the lifetime of a <a href="#networkservices"><code>NetworkServices</code></a> object.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   627
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   628
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   629
      <p class="note">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   630
        Each service in a <a href="#networkservices"><code>NetworkServices</code></a> object thus has an index; the first has the index 0, and each subsequent service is numbered one higher than the previous one. If the <a>user agent</a> dynamically adds or removes network services for any reason, then the indices of the services in <a>current authorized services</a> will change dynamically. If the set of network services changes entirely, then all the previous services will be removed from <a>current authorized services</a> and replaced with new services.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   631
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   632
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   633
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   634
        The <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/infrastructure.html#supported-property-indices" class="externalDFN">supported property indices</a> of <a href="#networkservices"><code>NetworkServices</code></a> objects at any instant are the numbers from zero to the number of items in <a>current authorized services</a> represented by the respective object minus one, if any services are represented in <a>current authorized services</a>. If a <a href="#networkservices"><code>NetworkServices</code></a> object represents no <a>current authorized services</a>, it has no <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/infrastructure.html#supported-property-indices" class="externalDFN">supported property indices</a>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   635
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   636
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   637
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   638
        To <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/infrastructure.html#determine-the-value-of-an-indexed-property" class="externalDFN">determine the value of an indexed property</a> for a given index <var>index</var> in a <a href="#networkservices"><code>NetworkServices</code></a> object's <a>current authorized services</a>, the user agent MUST return the <a href="#networkservice"><code>NetworkService</code></a> object that represents the <var>index</var>th service in <a>current authorized services</a>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   639
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   640
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   641
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   642
        The <dfn id="dom-networkservices-getservicebyid"><code>getServiceById(id)</code></dfn> method MUST return the first <a href="#networkservice"><code>NetworkService</code></a> object in <a>current authorized services</a> represented by the respective object whose <a href="#dom-networkservice-id"><code>id</code></a> attribute is equal to the value of the <var>id</var> argument.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   643
        When no services in <a>current authorized services</a> match the given argument, the method MUST return null.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   644
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   645
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   646
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   647
         Services available within the local network can connect and disconnect at different times during the execution of a web page. A <a>user agent</a> can
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   648
         inform a web page when the state of networked services matching the requested <a>valid service type</a> change. Web pages can use this information to enable in-page experiences for communicating the state of networked services
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   649
         with the ability to change the particular service or set of services the page is connected to by re-invoking the <a href="#dom-navigator-getnetworkservices"><code>getNetworkServices()</code></a> method.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   650
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   651
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   652
      </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   653
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   654
      <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   655
      <h2>Events</h2>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   656
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   657
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   658
         The following are the event handlers (and their corresponding event handler event types) that must be supported, as IDL attributes, by all objects implementing the <a href="#networkservices"><code>NetworkServices</code></a> interface:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   659
       </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   660
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   661
       <table border="1">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   662
        <thead>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   663
          <tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   664
            <th>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   665
              <span title="event handlers">Event handler</span>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   666
            </th>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   667
            <th>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   668
              <span>Event handler event type</span>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   669
            </th>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   670
          </tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   671
        </thead>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   672
        <tbody>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   673
          <tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   674
            <td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   675
              <dfn id="dom-networkservices-onserviceavailable" title="dom-NetworkServices-onserviceavailable">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   676
                <code>onserviceavailable</code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   677
              </dfn>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   678
            </td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   679
            <td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   680
              <code title="event-serviceavailable">serviceavailable</code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   681
            </td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   682
          </tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   683
          <tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   684
            <td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   685
              <dfn id="dom-networkservices-onserviceunavailable" title="dom-NetworkServices-onserviceunavailable">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   686
                <code>onserviceunavailable</code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   687
              </dfn>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   688
            </td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   689
            <td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   690
              <code title="event-serviceunavailable">serviceunavailable</code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   691
            </td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   692
          </tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   693
        </tbody>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   694
      </table>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   695
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   696
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   697
         Events with an event type of <code>serviceavailable</code> or <code>serviceunavailable</code> defined in this specification are simple <code>Event</code> objects.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   698
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   699
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   700
      </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   701
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   702
    </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   703
    <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   704
    <h2>Communicating with a networked service</h3>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   705
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   706
<p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   707
   The <a href="#networkservice"><code>NetworkService</code></a> interface is used to provide a set of connection information for an HTTP service endpoint and if available, service events, running on a networked device.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   708
</p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   709
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   710
<pre class="widl">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   711
[NoInterfaceObject]
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   712
interface <dfn id="networkservice">NetworkService</dfn> {
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   713
  readonly attribute DOMString        <a href="#dom-networkservice-id">id</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   714
  readonly attribute DOMString        <a href="#dom-networkservice-name">name</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   715
  readonly attribute DOMString        <a href="#dom-networkservice-type">type</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   716
  readonly attribute DOMString        <a href="#dom-networkservice-url">url</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   717
  readonly attribute DOMString        <a href="#dom-networkservice-config">config</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   718
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   719
  readonly attribute boolean          <a href="#dom-networkservice-online">online</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   720
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   721
  // event handler attributes
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   722
           attribute <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#eventhandler" class="externalDFN">EventHandler</a>     <a href="#dom-networkservice-onserviceonline">onserviceonline</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   723
           attribute <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#eventhandler" class="externalDFN">EventHandler</a>     <a href="#dom-networkservice-onserviceoffline">onserviceoffline</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   724
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   725
           attribute <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#eventhandler" class="externalDFN">EventHandler</a>     <a href="#dom-networkservice-onnotify">onnotify</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   726
};
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   727
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   728
<a href="#networkservice">NetworkService</a> implements <a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#interface-eventtarget" class="externalDFN">EventTarget</a>;
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   729
</pre>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   730
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   731
<section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   732
  <h2>Attributes</h2>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   733
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   734
      <dl class="domintro">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   735
        <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   736
          <var title="">service</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   737
           .
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   738
          <code title="dom-networkservice-id">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   739
            <a href="#dom-networkservice-id">id</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   740
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   741
        </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   742
        <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   743
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   744
            A unique identifier for the given user-selected service instance.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   745
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   746
        </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   747
        <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   748
          <var title="">service</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   749
           .
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   750
          <code title="dom-networkservice-name">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   751
            <a href="#dom-networkservice-name">name</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   752
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   753
        </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   754
        <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   755
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   756
            The name of the user-selected service.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   757
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   758
        </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   759
        <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   760
          <var title="">service</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   761
           .
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   762
          <code title="dom-networkservice-type">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   763
            <a href="#dom-networkservice-type">type</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   764
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   765
        </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   766
        <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   767
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   768
            The <a>valid service type</a> token value of the user-selected service.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   769
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   770
        </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   771
        <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   772
          <var title="">service</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   773
           .
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   774
          <code title="dom-networkservice-url">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   775
            <a href="#dom-networkservice-url">url</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   776
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   777
        </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   778
        <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   779
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   780
            The control URL endpoint (including any required port information) of the user-selected control service that has been added to the <a>entry script origin's URL whitelist</a>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   781
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   782
        </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   783
        <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   784
          <var title="">service</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   785
           .
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   786
          <code title="dom-networkservice-config">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   787
            <a href="#dom-networkservice-config">config</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   788
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   789
        </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   790
        <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   791
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   792
            The configuration information associated with the service depending on the requested service type.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   793
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   794
        </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   795
      </dl>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   796
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   797
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   798
            The <dfn id="dom-networkservice-id"><code>id</code></dfn> attribute is a unique identifier for the service. The same service provided at different times or on different objects MUST have the same <a href="#dom-networkservice-id"><code>id</code></a> value.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   799
         </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   800
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   801
         <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   802
            The <dfn id="dom-networkservice-name"><code>name</code></dfn> attribute represents a human-readable title for the service.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   803
         </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   804
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   805
         <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   806
             The <dfn id="dom-networkservice-type"><code>type</code></dfn> attribute reflects the value of the <a>valid service type</a> of the service.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   807
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   808
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   809
         <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   810
            The <dfn id="dom-networkservice-url"><code>url</code></dfn> attribute is an <a href="http://www.w3.org/TR/html5/urls.html#absolute-url" class="externalDFN">absolute URL</a> pointing to the root HTTP
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   811
            endpoint for the service that has been added to the <a>entry script origin's URL whitelist</a>. Web pages can subsequently use this value for implicit cross-document messaging via various existing mechanisms (e.g. Web Sockets, Server-Sent Events, Web Messaging, XMLHttpRequest).
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   812
         </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   813
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   814
         <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   815
            The <dfn id="dom-networkservice-config"><code>config</code></dfn> attribute provides the raw configuration information extracted from the given network service.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   816
         </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   817
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   818
      </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   819
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   820
      <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   821
         <h3>States</h3>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   822
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   823
      <dl class="domintro">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   824
        <dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   825
          <var title="">service</var>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   826
           .
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   827
          <code title="dom-networkservice-online">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   828
            <a href="#dom-networkservice-online">online</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   829
          </code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   830
        </dt>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   831
        <dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   832
          <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   833
            Returns <code>true</code> if the service is reporting that it is accessible on the local network or <code>false</code> if the service is reporting that it is no longer accessible (temporarily or permanently) on the local network.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   834
          </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   835
        </dd>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   836
      </dl>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   837
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   838
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   839
        The <dfn id="dom-networkservice-online"><code>online</code></dfn> attribute indicates whether the service is reporting itself as being
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   840
        either <var>online</var>, and therefore accessible on the local network, in which case this attribute will return <code>true</code> or, <var>offline</var>, and therefore not accessible on the local network, either temporarily or permanently, in which case this attribute will return <code>false</code>. This attribute MUST default to <code>true</code>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   841
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   842
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   843
      </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   844
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   845
      <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   846
         <h3>Events</h3>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   847
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   848
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   849
         The following are the event handlers (and their corresponding event handler event types) that must be supported, as IDL attributes, by all objects implementing the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   850
         <a href="#networkservice"><code>NetworkService</code></a> interface:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   851
       </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   852
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   853
       <table border="1">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   854
        <thead>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   855
          <tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   856
            <th>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   857
              <span title="event handlers">Event handler</span>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   858
            </th>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   859
            <th>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   860
              <span>Event handler event type</span>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   861
            </th>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   862
          </tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   863
        </thead>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   864
        <tbody>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   865
          <tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   866
            <td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   867
              <dfn id="dom-networkservice-onnotify" title="dom-NetworkService-onnotify">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   868
                <code>onnotify</code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   869
              </dfn>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   870
            </td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   871
            <td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   872
              <code title="event-notify">notify</code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   873
            </td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   874
          </tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   875
          <tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   876
            <td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   877
              <dfn id="dom-networkservice-onserviceonline" title="dom-NetworkService-onserviceonline">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   878
                <code>onserviceonline</code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   879
              </dfn>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   880
            </td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   881
            <td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   882
              <code title="event-onserviceonline">serviceonline</code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   883
            </td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   884
          </tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   885
          <tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   886
            <td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   887
              <dfn id="dom-networkservice-onserviceoffline" title="dom-NetworkService-onserviceoffline">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   888
                <code>onserviceoffline</code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   889
              </dfn>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   890
            </td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   891
            <td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   892
              <code title="event-onserviceoffline">serviceoffline</code>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   893
            </td>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   894
          </tr>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   895
        </tbody>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   896
      </table>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   897
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   898
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   899
         Events with an event type of <code>notify</code>, <code>serviceonline</code> or <code>serviceoffline</code> defined in this specification are simple <code>Event</code> objects.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   900
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   901
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   902
      </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   903
   </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   904
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   905
      <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   906
            <h2>Service Discovery</h2>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   907
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   908
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   909
         A <a>user agent</a> conforming to this specification MAY implement <acronym title="Simple Service Discovery Protocol">SSDP</acronym> [[!UPNP-DEVICEARCH11]] and Zeroconf [[!DNS-SD]] + [[!MDNS]] service discovery mechanisms
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   910
         to enable Web pages to request and connect with HTTP services running on networked devices, discovered via either mechanism, through this API. When a <a>user agent</a> implements either of these service discovery mechanisms, then it MUST conform to the corresponding algorithms provided in this section of the specification.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   911
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   912
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   913
         This section presents how the results of these two service discovery
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   914
         mechanisms will be matched to requested service types and how their properties will be applied to any resulting <a href="#networkservice"><code>NetworkService</code></a> objects.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   915
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   916
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   917
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   918
         It is expected that user agents will perform these service discovery mechansisms asynchronously and periodically update the <a>list of networked devices</a> as required. The timing of any
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   919
         service discovery mechanisms is an implementation detail left to the discretion of the implementer (e.g. once on user agent start-up, every X seconds during user agent execution or on
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   920
         invocation of this API from a Web page).
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   921
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   922
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   923
      <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   924
         The <dfn>list of available service records</dfn> is a single dynamic internal lookup table within user agents that is used to track the current services available in the network at any given time.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   925
         At any point during the running of either of the two service discovery mechanisms then existing entries within this table can be updated, entries can be added and entries can be removed as the status of networked
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   926
         services changes. Each record contained within this table contains the attributes: <code>id</code>, <code>name</code>, <code>type</code>, <code>url</code> and <code>config</code>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   927
      </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   928
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   929
            <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   930
         <h4>Zeroconf (<abbr title="Multicast DNS">mDNS</abbr> + <abbr title="Domain Name System">DNS</abbr>-<abbr title="Service Discovery">SD</abbr>)</h4>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   931
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   932
         <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   933
            For each DNS response received from a user-agent-initiated Multicast DNS Browse for <abbr title="DNS Pointer Record">PTR</abbr> records with the name <code>_services._dns-sd._udp</code> on the resolved recommended automatic browsing
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   934
   domain [[!MDNS]], the <a>user agent</a> MUST run the following steps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   935
         </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   936
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   937
         <ol class="rule">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   938
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   939
            <li>Let <var>service mDNS responses</var> be an array of PTR records received by issuing a Multicast DNS Browse for PTR records with the name of the current discovered service type.</li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   940
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   941
            <li>For each Object <var>service mDNS response</var> in <var>service mDNS responses</var>, run the following steps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   942
               <ol>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   943
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   944
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   945
                     Let <var>network service record</var> be an Object consisting of the following empty properties: <code>id</code>, <code>name</code>, <code>type</code>, <code>url</code>, <code>config</code>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   946
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   947
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   948
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   949
                     Set <var>network service record</var>'s <code>id</code> property to the value of the full PTR Service Instance Name [[!MDNS]].
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   950
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   951
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   952
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   953
                     Set <var>network service record</var>'s <code>name</code> property to the value of the PTR Service Instance Name's <var>Instance</var> component [[!MDNS]].
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   954
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   955
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   956
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   957
                     Set <var>network service record</var>'s <code>type</code> property to the concatenation of the string <code>zeroconf:</code> followed by the value of the PTR Service Instance Name's <var>Service</var> component [[!MDNS]].
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   958
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   959
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   960
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   961
                     Set <var>network service record</var>'s <code>url</code> property to the resolvable Service URL obtained from performing an DNS-SD Lookup [[!DNS-SD]] of the current service from the PTR record provided [[!MDNS]].
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   962
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   963
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   964
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   965
                     Set <var>network service record</var>'s <code>config</code> property to the string value of the contents of the first DNS-SD TXT record associated with the <var>service mDNS response</var> as defined in [[!DNS-SD]].
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   966
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   967
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   968
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   969
                     For each Object <var>existing service record</var> in the current <a>list of available service records</a>, run the following sub-steps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   970
                     <ol class="rule">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   971
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   972
                       <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   973
                        If the <var>existing service record</var>'s <code>id</code> property matches the value of the <var>network service record</var>'s <code>id</code>, then set the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   974
                        value of <var>existing service record</var> in the current <a>list of available service records</a>  to the value of the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   975
                        <var>network service record</var> and skip the next step.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   976
                       </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   977
                     </ol>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   978
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   979
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   980
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   981
                     Add <var>network service record</var> to the <a>list of available service records</a>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   982
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   983
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   984
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   985
                     For each non-garbage collected <a href="#networkservice"><code>NetworkService</code></a> object run the following steps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   986
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   987
                     <ol class="rule">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   988
                        <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   989
                           If the <a href="#networkservice"><code>NetworkService</code></a> object's <code>type</code> attribute does not equal the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   990
                           current <a>network service record</a>'s <code>type</code> property then continue at the next available active
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   991
                           <a href="#networkservice"><code>NetworkService</code></a> object.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   992
                        </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   993
                        <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   994
                           Increment the <a href="#dom-networkservices-servicesavailable"><code>servicesAvailable</code></a> attribute of the <a href="#networkservices"><code>NetworkServices</code></a> object by <code>1</code>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   995
                        </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   996
                        <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   997
                          <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">Queue a task</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   998
                           to dispatch a newly created event with the name <code>serviceavailable</code> that uses the <code>Event</code> interface, which does not bubble, is not cancellable, and has no default action, at the current
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
   999
                            <a href="#networkservices"><code>NetworkServices</code></a> object.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1000
                        </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1001
                        <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1002
                          <a href="http://www.whatwg.org/specs/web-apps/current-work/complete/webappapis.html#queue-a-task" class="externalDFN">Queue a task</a>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1003
                           to dispatch a newly created event with the name <code>serviceonline</code> that uses the <code>Event</code> interface, which does not bubble, is not cancellable, and has no default action, at the current
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1004
                           <a href="#networkservice"><code>NetworkService</code></a> object.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1005
                        </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1006
                     </ol>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1007
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1008
            </ol>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1009
           </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1010
         </ol>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1011
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1012
      </section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1013
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1014
      <section>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1015
         <h5>Universal Plug-and-Play (<abbr title="Universal Plug-and-Play">UPnP</abbr>)</h5>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1016
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1017
         <p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1018
            For each SSDP Presence Announcement [[!UPNP-DEVICEARCH11]] - a HTTP NOTIFY request - received from a user-agent-initiated SSDP Discovery Request [[!UPNP-DEVICEARCH11]], the <a>user agent</a> MUST run the following steps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1019
         </p>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1020
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1021
         <ol class="rule">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1022
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1023
               Let <var>ssdp device</var> be an Object with a property for each HTTP header received in the received SSDP Presence Announcement, with each key being the name of a HTTP header and its
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1024
               value being that HTTP header's accompanying value.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1025
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1026
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1027
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1028
               If <var>ssdp device</var> does not contain at least one <var>NTS</var>, <var>USN</var> and <var>Location</var> parameter, then the <a>user agent</a> MUST abort these steps.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1029
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1030
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1031
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1032
               If the first occurrence of <var>NTS</var> has a value other than <code>ssdp:alive</code>, then continue to the step labeled <var>update service monitor</var> below.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1033
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1034
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1035
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1036
               Let <var>root device descriptor file</var> contain the contents of the file located at the URL provided in the first occurrence of <var>Location</var> obtained according to the rules
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1037
               defined in the section 'Retrieving a description using HTTP' [[!UPNP-DEVICEARCH11]].
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1038
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1039
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1040
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1041
               If <var>root device descriptor file</var> is empty, then the <a>user agent</a> MUST abort these steps.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1042
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1043
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1044
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1045
               Let <var>advertised services</var> be a <a>list of all advertised services</a> obtained from the <var>root device descriptor file</var> containing all sub-nodes of the <code>serviceList</code> node as described in
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1046
               the section 'Device Description' [[!UPNP-DEVICEARCH11]].
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1047
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1048
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1049
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1050
               For each Object <var>advertised service</var> in <var>advertised services</var> run the following steps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1051
               <ol class="rule">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1052
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1053
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1054
                     Let <var>network service record</var> be an Object consisting of the following empty properties: <code>id</code>, <code>name</code>, <code>type</code>, <code>url</code>, <code>eventsUrl</code>, <code>config</code>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1055
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1056
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1057
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1058
                     Set <var>network service record</var>'s <code>id</code> property to the string value of the first occurrence of <var>ssdp device</var>'s <var>USN</var> parameter.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1059
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1060
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1061
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1062
                     Set <var>network service record</var>'s <code>name</code> property to the string value of the first occurrence of the <var>service</var>'s <code>serviceId</code> property.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1063
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1064
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1065
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1066
                     Set <var>network service record</var>'s <code>type</code> property to the concatenation of the string <code>upnp:</code> followed by the string value of the first occurrence of the <var>service</var>'s <code>serviceType</code> property.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1067
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1068
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1069
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1070
                     Set <var>network service record</var>'s <code>url</code> property to the string value of the first occurrence of the <var>service</var>'s <code>controlURL</code> property.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1071
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1072
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1073
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1074
                     Set <var>network service record</var>'s <code>config</code> property to the string value of the first occurrence of the <var>device</var> property.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1075
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1076
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1077
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1078
                     If <var>service</var>'s <code>eventSubURL</code> property is empty, then continue to the step labeled <em>register</em> below.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1079
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1080
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1081
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1082
                     Set <var>network service record</var>'s <code>eventsUrl</code> property to the string value of the first occurrence of the <var>service</var>'s <code>eventSubURL</code> property.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1083
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1084
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1085
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1086
                     <em>Register</em>: For each Object <var>existing service record</var> in the current <a>list of available service records</a>, run the following sub-steps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1087
                     <ol class="rule">
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1088
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1089
                       <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1090
                        If the <var>existing service record</var>'s <var>id</var> property matches the value of the first occurrence of <var>USN</var> and the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1091
                        <var>existing service record</var>'s <code>type</code> property matches the value of <var>network service record</var>'s <code>type</code>, then set the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1092
                        value of <var>existing service record</var> in the current <a>list of available service records</a>  to the value of the
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1093
                        <var>network service record</var> and skip the next step.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1094
                       </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1095
                     </ol>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1096
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1097
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1098
                  <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1099
                     Add <var>network service record</var> to the <a>list of available service records</a>.
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1100
                  </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1101
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1102
               </ol>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1103
            </li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1104
            <li>
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1105
               <em>Update Service Monitor</em>: For each non-garbage collected <a href="#networkservice"><code>NetworkService</code></a> object run the following steps:
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents:
diff changeset
  1106
53f4bfeee4fe Revert the majority of commit 9e85394e6ede due to the deletion of files. Please always do 'hg pull' followed by 'hg update' before committing your own changes to this repo.
Rich Tibbett <richt@opera.com>
parents: