author Boris Zbarsky <>
Wed, 02 Dec 2015 13:52:59 -0500
changeset 275242 87d9fe68abf24bd062bc8ef140c3fed161ec6182
parent 221874 fea8c83aef600f036ee901c2a7dc9d3e5f00557b
child 275243 932fcd51eacef36cc2b568d719f830f3f7b5b2c7
permissions -rw-r--r--
Bug 1228702. Don't expose the 'location' property of Exception/DOMException on workers. r=bholley

/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
 * You can obtain one at
 * The origin of this IDL file is
 * Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C
 * liability, trademark and document use rules apply.

// This is the WebIDL version of nsIException.  This is mostly legacy stuff.

interface StackFrame;

interface ExceptionMembers
  // A custom message set by the thrower.  LenientThis so it can be
  // gotten on the prototype, which Error.prototype.toString will do
  // if someone tries to stringify DOMException.prototype.
  readonly attribute DOMString               message;
  // The nsresult associated with this exception.
  readonly attribute unsigned long           result;
  // The name of the error code (ie, a string repr of |result|).
  // LenientThis so it can be gotten on the prototype, which
  // Error.prototype.toString will do if someone tries to stringify
  // DOMException.prototype.
  readonly attribute DOMString               name;

  // Filename location.  This is the location that caused the
  // error, which may or may not be a source file location.
  // For example, standard language errors would generally have
  // the same location as their top stack entry.  File
  // parsers may put the location of the file they were parsing,
  // etc.

  // null indicates "no data"
  readonly attribute DOMString               filename;
  // Valid line numbers begin at '1'. '0' indicates unknown.
  readonly attribute unsigned long           lineNumber;
  // Valid column numbers begin at 0. 
  // We don't have an unambiguous indicator for unknown.
  readonly attribute unsigned long           columnNumber;

  // A stack trace, if available.  nsIStackFrame does not have classinfo so
  // this was only ever usefully available to chrome JS.
  [ChromeOnly, Exposed=Window]
  readonly attribute StackFrame?             location;
  // An inner exception that triggered this, if available.
  readonly attribute nsISupports?            inner;

  // Arbitary data for the implementation.
  readonly attribute nsISupports?            data;

  // Formatted exception stack
  [Throws, Replaceable]
  readonly attribute DOMString               stack;

[NoInterfaceObject, Exposed=(Window,Worker)]
interface Exception {
  // A generic formatter - make it suitable to print, etc.

Exception implements ExceptionMembers;

// XXXkhuey this is an 'exception', not an interface, but we don't have any
// parser or codegen mechanisms for dealing with exceptions.
 Exposed=(Window, Worker),
 Constructor(optional DOMString message = "", optional DOMString name)]
interface DOMException {
  const unsigned short INDEX_SIZE_ERR = 1;
  const unsigned short DOMSTRING_SIZE_ERR = 2; // historical
  const unsigned short HIERARCHY_REQUEST_ERR = 3;
  const unsigned short WRONG_DOCUMENT_ERR = 4;
  const unsigned short INVALID_CHARACTER_ERR = 5;
  const unsigned short NO_DATA_ALLOWED_ERR = 6; // historical
  const unsigned short NO_MODIFICATION_ALLOWED_ERR = 7;
  const unsigned short NOT_FOUND_ERR = 8;
  const unsigned short NOT_SUPPORTED_ERR = 9;
  const unsigned short INUSE_ATTRIBUTE_ERR = 10; // historical
  const unsigned short INVALID_STATE_ERR = 11;
  const unsigned short SYNTAX_ERR = 12;
  const unsigned short INVALID_MODIFICATION_ERR = 13;
  const unsigned short NAMESPACE_ERR = 14;
  const unsigned short INVALID_ACCESS_ERR = 15;
  const unsigned short VALIDATION_ERR = 16; // historical
  const unsigned short TYPE_MISMATCH_ERR = 17; // historical; use JavaScript's TypeError instead
  const unsigned short SECURITY_ERR = 18;
  const unsigned short NETWORK_ERR = 19;
  const unsigned short ABORT_ERR = 20;
  const unsigned short URL_MISMATCH_ERR = 21;
  const unsigned short QUOTA_EXCEEDED_ERR = 22;
  const unsigned short TIMEOUT_ERR = 23;
  const unsigned short INVALID_NODE_TYPE_ERR = 24;
  const unsigned short DATA_CLONE_ERR = 25;

  readonly attribute unsigned short code;

// XXXkhuey copy all of Gecko's non-standard stuff onto DOMException, but leave
// the prototype chain sane.
DOMException implements ExceptionMembers;