@DomName('Navigator')
class Navigator native "Navigator" {

 @DomName('Navigator.language')
 String get language => JS('String', '#.language || #.userLanguage', this,
     this);

 /**
  * Gets a stream (video and or audio) from the local computer.
  *
  * Use [MediaStream.supported] to check if this is supported by the current
  * platform. The arguments `audio` and `video` default to `false` (stream does
  * not use audio or video, respectively).
  *
  * Simple example usage:
  *
  *     window.navigator.getUserMedia(audio: true, video: true).then((stream) {
  *       var video = new VideoElement()
  *         ..autoplay = true
  *         ..src = Url.createObjectUrl(stream);
  *       document.body.append(video);
  *     });
  *
  * The user can also pass in Maps to the audio or video parameters to specify 
  * mandatory and optional constraints for the media stream. Not passing in a 
  * map, but passing in `true` will provide a MediaStream with audio or 
  * video capabilities, but without any additional constraints. The particular
  * constraint names for audio and video are still in flux, but as of this 
  * writing, here is an example providing more constraints.
  *
  *     window.navigator.getUserMedia(
  *         audio: true, 
  *         video: {'mandatory': 
  *                    { 'minAspectRatio': 1.333, 'maxAspectRatio': 1.334 },
  *                 'optional': 
  *                    [{ 'minFrameRate': 60 },
  *                     { 'maxWidth': 640 }]
  *     });
  *
  * See also:
  * * [MediaStream.supported]
  */
 @DomName('Navigator.webkitGetUserMedia')
 @SupportedBrowser(SupportedBrowser.CHROME)
 @Experimental
 Future<MediaStream> getUserMedia({audio: false, video: false}) {
   var completer = new Completer<MediaStream>();
   var options = {
     'audio': audio,
     'video': video
   };
   _ensureGetUserMedia();
   this._getUserMedia(convertDartToNative_SerializedScriptValue(options),
     (stream) {
       completer.complete(stream);
     },
     (error) {
       completer.completeError(error);
     });
   return completer.future;
 }

 _ensureGetUserMedia() {
   if (JS('bool', '!(#.getUserMedia)', this)) {
     JS('void', '#.getUserMedia = '
         '(#.getUserMedia || #.webkitGetUserMedia || #.mozGetUserMedia ||'
         '#.msGetUserMedia)', this, this, this, this, this);
   }
 }

 @JSName('getUserMedia')
 void _getUserMedia(options, _NavigatorUserMediaSuccessCallback success,
     _NavigatorUserMediaErrorCallback error) native;


 @DomName('Navigator.appCodeName')
 @DocsEditable
 final String appCodeName;

 @DomName('Navigator.appName')
 @DocsEditable
 final String appName;

 @DomName('Navigator.appVersion')
 @DocsEditable
 final String appVersion;

 @DomName('Navigator.cookieEnabled')
 @DocsEditable
 final bool cookieEnabled;

 @DomName('Navigator.doNotTrack')
 @DocsEditable
 final String doNotTrack;

 @DomName('Navigator.geolocation')
 @DocsEditable
 final Geolocation geolocation;

 @DomName('Navigator.mimeTypes')
 @DocsEditable
 final MimeTypeArray mimeTypes;

 @DomName('Navigator.onLine')
 @DocsEditable
 final bool onLine;

 @DomName('Navigator.platform')
 @DocsEditable
 final String platform;

 @DomName('Navigator.plugins')
 @DocsEditable
 final PluginArray plugins;

 @DomName('Navigator.product')
 @DocsEditable
 final String product;

 @DomName('Navigator.productSub')
 @DocsEditable
 final String productSub;

 @DomName('Navigator.userAgent')
 @DocsEditable
 final String userAgent;

 @DomName('Navigator.vendor')
 @DocsEditable
 final String vendor;

 @DomName('Navigator.vendorSub')
 @DocsEditable
 final String vendorSub;

 @JSName('webkitPersistentStorage')
 @DomName('Navigator.webkitPersistentStorage')
 @DocsEditable
 @SupportedBrowser(SupportedBrowser.CHROME)
 @SupportedBrowser(SupportedBrowser.SAFARI)
 @Experimental
 final StorageQuota persistentStorage;

 @JSName('webkitTemporaryStorage')
 @DomName('Navigator.webkitTemporaryStorage')
 @DocsEditable
 @SupportedBrowser(SupportedBrowser.CHROME)
 @SupportedBrowser(SupportedBrowser.SAFARI)
 @Experimental
 final StorageQuota temporaryStorage;

 @DomName('Navigator.getStorageUpdates')
 @DocsEditable
 void getStorageUpdates() native;

 @DomName('Navigator.javaEnabled')
 @DocsEditable
 bool javaEnabled() native;

 @DomName('Navigator.registerProtocolHandler')
 @DocsEditable
 void registerProtocolHandler(String scheme, String url, String title) native;

 @JSName('webkitGetGamepads')
 @DomName('Navigator.webkitGetGamepads')
 @DocsEditable
 @SupportedBrowser(SupportedBrowser.CHROME)
 @SupportedBrowser(SupportedBrowser.SAFARI)
 @Experimental
 @Returns('_GamepadList')
 @Creates('_GamepadList')
 List<Gamepad> getGamepads() native;

}