Summary

Mark the deprecated netscape.javascript.JSObject::getWindow method with "forRemoval=true".

Problem

The JSObject::getWindow method has been deprecated since JDK 9. With the removal of Java Plugin, there is no longer a useful way to use this method. We would like to remove it in a future release to remove the dependency from the jdk.jsobject module on the java.desktop module.

Solution

Add "forRemoval=true" to the existing @Deprecated annotation of netscape.javascript.JSObject::getWindow.

Specification

--- a/src/jdk.jsobject/share/classes/netscape/javascript/JSObject.java
+++ b/src/jdk.jsobject/share/classes/netscape/javascript/JSObject.java
@@ -150,12 +150,12 @@
      * @throws JSException when an error is reported from the browser or
      * JavaScript engine or if applet is {@code null}
      *
-     * @deprecated  The Applet API is deprecated. See the
+     * @deprecated The Applet API is deprecated, no replacement. See the
      * <a href="{@docRoot}/java.desktop/java/applet/package-summary.html">
      * java.applet package documentation</a> for further information.
      */

-    @Deprecated(since = "9")
+    @Deprecated(since="9", forRemoval=true)
     @SuppressWarnings("exports")
     public static JSObject getWindow(Applet applet) throws JSException {
         return ProviderLoader.callGetWindow(applet);