1 /* -*- Mode: java; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*- 2 * 3 * The contents of this file are subject to the Netscape Public 4 * License Version 1.1 (the "License"); you may not use this file 5 * except in compliance with the License. You may obtain a copy of 6 * the License at http://www.mozilla.org/NPL/ 7 * 8 * Software distributed under the License is distributed on an "AS 9 * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or 10 * implied. See the License for the specific language governing 11 * rights and limitations under the License. 12 * 13 * The Original Code is Rhino code, released 14 * May 6, 1999. 15 * 16 * The Initial Developer of the Original Code is Netscape 17 * Communications Corporation. Portions created by Netscape are 18 * Copyright (C) 1997-1999 Netscape Communications Corporation. All 19 * Rights Reserved. 20 * 21 * Contributor(s): 22 * Norris Boyd 23 * 24 * Alternatively, the contents of this file may be used under the 25 * terms of the GNU Public License (the "GPL"), in which case the 26 * provisions of the GPL are applicable instead of those above. 27 * If you wish to allow use of your version of this file only 28 * under the terms of the GPL and not to allow others to use your 29 * version of this file under the NPL, indicate your decision by 30 * deleting the provisions above and replace them with the notice 31 * and other provisions required by the GPL. If you do not delete 32 * the provisions above, a recipient may use your version of this 33 * file under either the NPL or the GPL. 34 */ 35 // Modified by Google 36 37 // API class 38 39 package com.google.gwt.dev.js.rhino; 40 41 42 /** 43 * Java reflection of JavaScript exceptions. (Possibly wrapping a Java exception.) 44 * 45 * @author Mike McCabe 46 */ 47 public class JavaScriptException extends Exception { 48 49 /** 50 * Create a JavaScript exception wrapping the given JavaScript value. 51 * 52 * Instances of this class are thrown by the JavaScript 'throw' keyword. 53 * 54 * @param value the JavaScript value thrown. 55 */ 56 public JavaScriptException(Object value) { 57 super(value.toString()); 58 this.value = value; 59 } 60 61 /** 62 * Get the exception value originally thrown. This may be a 63 * JavaScript value (null, undefined, Boolean, Number, String, 64 * Scriptable or Function) or a Java exception value thrown from a 65 * host object or from Java called through LiveConnect. 66 * 67 * @return the value wrapped by this exception 68 */ 69 public Object getValue() { 70 return value; 71 } 72 73 /** 74 * The JavaScript exception value. This value is not 75 * intended for general use; if the JavaScriptException wraps a 76 * Java exception, getScriptableValue may return a Scriptable 77 * wrapping the original Java exception object. 78 * 79 * We would prefer to go through a getter to encapsulate the value, 80 * however that causes the bizarre error "nanosecond timeout value 81 * out of range" on the MS JVM. 82 * @serial 83 */ 84 Object value; 85 } 86