From 89f54ff67255c1ccbdf42a5a3649736cc6fc73c0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philip=20J=C3=A4genstedt?= <philip@foolip.org>
Date: Fri, 15 Jun 2018 13:45:00 +0200
Subject: [PATCH] Make SpeechSynthesisUtterance's voice attribute nullable

Tests: TODO

Fixes https://www.w3.org/Bugs/Public/show_bug.cgi?id=30010.
---
 index.bs | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/index.bs b/index.bs
index 20c3bc0..156f539 100644
--- a/index.bs
+++ b/index.bs
@@ -562,7 +562,7 @@ partial interface Window {
 interface SpeechSynthesisUtterance : EventTarget {
     attribute DOMString text;
     attribute DOMString lang;
-    attribute SpeechSynthesisVoice voice;
+    attribute SpeechSynthesisVoice? voice;
     attribute float volume;
     attribute float rate;
     attribute float pitch;
@@ -690,10 +690,11 @@ interface SpeechSynthesisVoice {
   This default value is computed and used when the input request opens a connection to the recognition service.</dd>
 
   <dt><dfn attribute for=SpeechSynthesisUtterance>voice</dfn> attribute</dt>
-  <dd>The voice attribute specifies speech synthesis voice that the web application wishes to use.
-  If, at the time of the play method call, this attribute has been set to one of the SpeechSynthesisVoice objects returned by getVoices, then the user agent must use that voice.
-  If this attribute is unset or null at the time of the play method call, then the user agent must use a user agent default voice.
-  The user agent default voice should support the current language (see "lang" attribute) and can be a local or remote speech service and can incorporate end user choices via interfaces provided by the user agent such as browser configuration parameters.
+  <dd>This attribute specifies the speech synthesis voice that the web application wishes to use.
+  When a {{SpeechSynthesisUtterance}} object is created this attribute must be initialized to null.
+  If, at the time of the {{speak()}} method call, this attribute has been set to one of the {{SpeechSynthesisVoice}} objects returned by {{getVoices()}}, then the user agent must use that voice.
+  If this attribute is unset or null at the time of the {{speak()}} method call, then the user agent must use a user agent default voice.
+  The user agent default voice should support the current language (see {{SpeechSynthesisUtterance/lang}}) and can be a local or remote speech service and can incorporate end user choices via interfaces provided by the user agent such as browser configuration parameters.
   </dd>
 
   <dt><dfn attribute for=SpeechSynthesisUtterance>volume</dfn> attribute</dt>