dap: discovery-api/Overview.src.html@8b03e17da083 (annotated)

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

author	Rich Tibbett <richt@opera.com>
	Mon, 04 Feb 2013 13:47:41 +0100
changeset 371	8b03e17da083
parent 332	e19dc529aacc
child 372	7639401e21f4
permissions	-rw-r--r--