/*
    * Copyright (c) 2002-2026 Gargoyle Software Inc.
    *
    * Licensed under the Apache License, Version 2.0 (the "License");
    * you may not use this file except in compliance with the License.
    * You may obtain a copy of the License at
    * https://www.apache.org/licenses/LICENSE-2.0
    *
    * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  package org.htmlunit.javascript.host;
  
  import static org.htmlunit.BrowserVersionFeatures.JS_LOCATION_IGNORE_QUERY_FOR_ABOUT_PROTOCOL;
  import static org.htmlunit.BrowserVersionFeatures.JS_LOCATION_RELOAD_REFERRER;
  
  import java.io.IOException;
  import java.lang.reflect.Method;
  import java.net.MalformedURLException;
  import java.net.URL;
  
  import org.apache.commons.logging.Log;
  import org.apache.commons.logging.LogFactory;
  import org.htmlunit.BrowserVersion;
  import org.htmlunit.Page;
  import org.htmlunit.WebRequest;
  import org.htmlunit.WebWindow;
  import org.htmlunit.corejs.javascript.Context;
  import org.htmlunit.corejs.javascript.Function;
  import org.htmlunit.corejs.javascript.FunctionObject;
  import org.htmlunit.corejs.javascript.ScriptableObject;
  import org.htmlunit.corejs.javascript.VarScope;
  import org.htmlunit.html.HtmlPage;
  import org.htmlunit.javascript.HtmlUnitScriptable;
  import org.htmlunit.javascript.JavaScriptEngine;
  import org.htmlunit.javascript.configuration.JsxClass;
  import org.htmlunit.javascript.configuration.JsxConstructor;
  import org.htmlunit.javascript.host.event.Event;
  import org.htmlunit.javascript.host.event.HashChangeEvent;
  import org.htmlunit.protocol.javascript.JavaScriptURLConnection;
  import org.htmlunit.util.StringUtils;
  import org.htmlunit.util.UrlUtils;
  
  /**
   * JavaScript host object for {@code Location}.
   *
   * @author Mike Bowler
   * @author Michael Ottati
   * @author Marc Guillemot
   * @author Chris Erskine
   * @author Daniel Gredler
   * @author David K. Taylor
   * @author Ahmed Ashour
   * @author Ronald Brill
   * @author Frank Danek
   * @author Adam Afeltowicz
   * @author Atsushi Nakagawa
   * @author Lai Quang Duong
   * @author Kanoko Yamamoto
   *
   * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location">MDN Documentation</a>
   */
  @JsxClass
  public class Location extends HtmlUnitScriptable {
  
      private static final Log LOG = LogFactory.getLog(Location.class);
      private static final String UNKNOWN = "null";
  
      /**
       * The window which owns this location object.
       */
      private Window window_;
  
      private static final Method METHOD_ASSIGN;
      private static final Method METHOD_RELOAD;
      private static final Method METHOD_REPLACE;
      private static final Method METHOD_TO_STRING;
  
      private static final Method GETTER_HASH;
      private static final Method SETTER_HASH;
  
      private static final Method GETTER_HOST;
      private static final Method SETTER_HOST;
  
      private static final Method GETTER_HOSTNAME;
      private static final Method SETTER_HOSTNAME;
  
      private static final Method GETTER_HREF;
      private static final Method SETTER_HREF;
  
      private static final Method GETTER_ORIGIN;
  
      private static final Method GETTER_PATHNAME;
      private static final Method SETTER_PATHNAME;
  
      private static final Method GETTER_PORT;
     private static final Method SETTER_PORT;
 
     private static final Method GETTER_PROTOCOL;
     private static final Method SETTER_PROTOCOL;
 
     private static final Method GETTER_SEARCH;
     private static final Method SETTER_SEARCH;
 
     static {
         try {
             METHOD_ASSIGN = Location.class.getDeclaredMethod("assign", String.class);
             METHOD_RELOAD = Location.class.getDeclaredMethod("reload", boolean.class);
             METHOD_REPLACE = Location.class.getDeclaredMethod("replace", String.class);
             METHOD_TO_STRING = Location.class.getDeclaredMethod("jsToString");
 
             GETTER_HASH = Location.class.getDeclaredMethod("getHash");
             SETTER_HASH = Location.class.getDeclaredMethod("setHash", String.class);
 
             GETTER_HOST = Location.class.getDeclaredMethod("getHost");
             SETTER_HOST = Location.class.getDeclaredMethod("setHost", String.class);
 
             GETTER_HOSTNAME = Location.class.getDeclaredMethod("getHostname");
             SETTER_HOSTNAME = Location.class.getDeclaredMethod("setHostname", String.class);
 
             GETTER_HREF = Location.class.getDeclaredMethod("getHref");
             SETTER_HREF = Location.class.getDeclaredMethod("setHref", String.class);
 
             GETTER_ORIGIN = Location.class.getDeclaredMethod("getOrigin");
 
             GETTER_PATHNAME = Location.class.getDeclaredMethod("getPathname");
             SETTER_PATHNAME = Location.class.getDeclaredMethod("setPathname", String.class);
 
             GETTER_PORT = Location.class.getDeclaredMethod("getPort");
             SETTER_PORT = Location.class.getDeclaredMethod("setPort", String.class);
 
             GETTER_PROTOCOL = Location.class.getDeclaredMethod("getProtocol");
             SETTER_PROTOCOL = Location.class.getDeclaredMethod("setProtocol", String.class);
 
             GETTER_SEARCH = Location.class.getDeclaredMethod("getSearch");
             SETTER_SEARCH = Location.class.getDeclaredMethod("setSearch", String.class);
         }
         catch (NoSuchMethodException | SecurityException e) {
             throw new RuntimeException(e);
         }
     }
 
     /**
      * The current hash; cached locally to avoid modifying the page's URL and
      * forcing a page reload each time this changes.
      */
     private String hash_;
 
     /**
      * Creates an instance of this object.
      *
      * @param cx the current context
      * @param scope the scope
      * @param args the constructor arguments
      * @param ctorObj the function object
      * @param inNewExpr whether invoked via {@code new}
      * @return the new {@code Location} instance
      */
     @JsxConstructor
     public static Location jsConstructor(final Context cx, final VarScope scope,
             final Object[] args, final Function ctorObj, final boolean inNewExpr) {
 
         final Location location = new Location();
         location.setParentScope(scope);
         location.setPrototype(((FunctionObject) ctorObj).getClassPrototype());
 
         location.initialize(scope, null, null);
 
         return location;
     }
 
     /**
      * Initializes this {@code Location}.
      *
      * @param scope the scope
      * @param window the window that this location belongs to
      * @param page the page that will become the enclosing page
      */
     public void initialize(final VarScope scope, final Window window, final Page page) {
         final int attributes = ScriptableObject.PERMANENT | ScriptableObject.READONLY;
 
         FunctionObject functionObject = new FunctionObject(METHOD_ASSIGN.getName(), METHOD_ASSIGN, scope);
         defineProperty(METHOD_ASSIGN.getName(), functionObject, attributes);
 
         functionObject = new FunctionObject(METHOD_RELOAD.getName(), METHOD_RELOAD, scope);
         defineProperty(METHOD_RELOAD.getName(), functionObject, attributes);
 
         functionObject = new FunctionObject(METHOD_REPLACE.getName(), METHOD_REPLACE, scope);
         defineProperty(METHOD_REPLACE.getName(), functionObject, attributes);
 
         functionObject = new FunctionObject(METHOD_TO_STRING.getName(), METHOD_TO_STRING, scope);
         defineProperty("toString", functionObject, attributes);
 
         defineProperty(scope, "hash", null, GETTER_HASH, SETTER_HASH, attributes);
         defineProperty(scope, "host", null, GETTER_HOST, SETTER_HOST, attributes);
         defineProperty(scope, "hostname", null, GETTER_HOSTNAME, SETTER_HOSTNAME, attributes);
         defineProperty(scope, "href", null, GETTER_HREF, SETTER_HREF, attributes);
         defineProperty(scope, "origin", null, GETTER_ORIGIN, null, attributes);
         defineProperty(scope, "pathname", null, GETTER_PATHNAME, SETTER_PATHNAME, attributes);
         defineProperty(scope, "port", null, GETTER_PORT, SETTER_PORT, attributes);
         defineProperty(scope, "protocol", null, GETTER_PROTOCOL, SETTER_PROTOCOL, attributes);
         defineProperty(scope, "search", null, GETTER_SEARCH, SETTER_SEARCH, attributes);
 
         window_ = window;
         if (window_ != null && page != null) {
             setHash(null, page.getUrl().getRef());
         }
     }
 
     /**
      * {@inheritDoc}
      */
     @Override
     public Object getDefaultValue(final Class<?> hint) {
         if (getPrototype() != null
                 && window_ != null
                 && (hint == null || String.class.equals(hint))) {
             return getHref();
         }
         return super.getDefaultValue(hint);
     }
 
     /**
      * Loads the new HTML document corresponding to the specified URL.
      *
      * @param url the URL of the new HTML document to load
      * @throws IOException if loading the specified location fails
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/assign">MDN Documentation</a>
      */
     public void assign(final String url) throws IOException {
         setHref(url);
     }
 
     /**
      * Reloads the current page, optionally forcing retrieval from the server even if
      * the browser cache contains the latest version of the document.
      *
      * @param force if {@code true}, force reload from the server; otherwise, the browser may reload from cache
      * @throws IOException if there is a problem reloading the page
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/reload">MDN Documentation</a>
      */
     public void reload(final boolean force) throws IOException {
         final WebWindow webWindow = window_.getWebWindow();
         final HtmlPage htmlPage = (HtmlPage) webWindow.getEnclosedPage();
         final WebRequest request = htmlPage.getWebResponse().getWebRequest();
 
         // update request url with location.href in case hash was changed
         request.setUrl(new URL(getHref()));
         if (getBrowserVersion().hasFeature(JS_LOCATION_RELOAD_REFERRER)) {
             request.setRefererHeader(htmlPage.getUrl());
         }
 
         webWindow.getWebClient().download(webWindow, "", request, false, null, "JS location.reload");
     }
 
     /**
      * Loads the document at the specified URL, replacing the current entry in the session history
      * so that the previous page cannot be reached via the back button.
      *
      * @param url the new URL to load
      * @throws IOException if loading the specified location fails
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/replace">MDN Documentation</a>
      */
     public void replace(final String url) throws IOException {
         window_.getWebWindow().getHistory().removeCurrent();
         setHref(url);
     }
 
     /**
      * Returns the location URL as a string.
      *
      * @return the location URL
      */
     public String jsToString() {
         if (window_ != null) {
             return getHref();
         }
         return "";
     }
 
     /**
      * Returns the full URL of the current page.
      *
      * @return the location URL
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/href">MDN Documentation</a>
      */
     public String getHref() {
         final WebWindow webWindow = window_.getWebWindow();
         final Page page = webWindow.getEnclosedPage();
         if (page == null) {
             return UNKNOWN;
         }
         try {
             URL url = page.getUrl();
             final String hash = getHash(true);
             if (hash != null) {
                 url = UrlUtils.getUrlWithNewRef(url, hash);
             }
             String s = url.toExternalForm();
             if (s.startsWith("file:/") && !s.startsWith("file:///")) {
                 // Java (sometimes?) returns file URLs with a single slash; however, browsers return
                 // three slashes. See http://www.cyanwerks.com/file-url-formats.html for more info.
                 s = "file:///" + s.substring("file:/".length());
             }
             return s;
         }
         catch (final MalformedURLException e) {
             if (LOG.isErrorEnabled()) {
                 LOG.error(e.getMessage(), e);
             }
             return page.getUrl().toExternalForm();
         }
     }
 
     /**
      * Sets the location URL to an entirely new value, navigating to the new page.
      *
      * @param newLocation the new location URL
      * @throws IOException if loading the specified location fails
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/href">MDN Documentation</a>
      */
     public void setHref(final String newLocation) throws IOException {
         if (newLocation.startsWith(JavaScriptURLConnection.JAVASCRIPT_PREFIX)) {
             final String script = newLocation.substring(11);
             final HtmlPage page = (HtmlPage) window_.getWebWindow().getEnclosedPage();
             page.executeJavaScript(script, "new location value", 1);
             return;
         }
 
         try {
             // we need to get the caller window to get the calling page
             WebWindow webWindow = ((Window) JavaScriptEngine.getTopCallScope().getGlobalThis()).getWebWindow();
             final HtmlPage callingPage = (HtmlPage) webWindow.getEnclosedPage();
 
             final BrowserVersion browserVersion = webWindow.getWebClient().getBrowserVersion();
 
             URL url = callingPage.getFullyQualifiedUrl(newLocation);
             // fix for empty url
             if (StringUtils.isEmptyOrNull(newLocation)) {
                 url = UrlUtils.getUrlWithNewRef(url, null);
             }
 
             final WebRequest request = new WebRequest(url,
                         browserVersion.getHtmlAcceptHeader(), browserVersion.getAcceptEncodingHeader());
             request.setRefererHeader(callingPage.getUrl());
 
             webWindow = window_.getWebWindow();
             webWindow.getWebClient().download(webWindow, "", request, true, null, "JS set location");
         }
         catch (final MalformedURLException e) {
             if (LOG.isErrorEnabled()) {
                 LOG.error("setHref('" + newLocation + "') got MalformedURLException", e);
             }
             throw e;
         }
     }
 
     /**
      * Returns the search portion of the location URL (the portion following the {@code ?}).
      *
      * @return the search portion of the location URL
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/search">MDN Documentation</a>
      */
     public String getSearch() {
         final URL url = getUrl();
         final String search = url.getQuery();
         if (StringUtils.isEmptyOrNull(search)) {
             return "";
         }
 
         if (StringUtils.startsWithIgnoreCase(url.getProtocol(), UrlUtils.ABOUT)
                 && window_.getWebWindow().getWebClient().getBrowserVersion()
                                 .hasFeature(JS_LOCATION_IGNORE_QUERY_FOR_ABOUT_PROTOCOL)) {
             return "";
         }
         return "?" + search;
     }
 
     /**
      * Sets the search portion of the location URL (the portion following the {@code ?}).
      *
      * @param search the new search portion of the location URL
      * @throws Exception if an error occurs
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/search">MDN Documentation</a>
      */
     public void setSearch(final String search) throws Exception {
         setUrl(UrlUtils.getUrlWithNewQuery(getUrl(), search));
     }
 
     /**
      * Returns the hash portion of the location URL (the portion following the {@code #}).
      *
      * @return the hash portion of the location URL
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/hash">MDN Documentation</a>
      */
     public String getHash() {
         if (StringUtils.isEmptyOrNull(hash_)) {
             return "";
         }
 
         if (hash_.indexOf('%') == -1) {
             return "#" + UrlUtils.encodeHash(hash_);
         }
         return "#" + UrlUtils.encodeHash(UrlUtils.decode(hash_));
     }
 
     private String getHash(final boolean encoded) {
         if (hash_ == null || hash_.isEmpty()) {
             return null;
         }
         if (encoded) {
             return UrlUtils.encodeHash(hash_);
         }
         return hash_;
     }
 
     /**
      * Sets the hash portion of the location URL (the portion following the {@code #}).
      * This method does not cause a server hit.
      *
      * @param hash the new hash portion of the location URL
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/hash">MDN Documentation</a>
      */
     public void setHash(final String hash) {
         // IMPORTANT: This method must not call setUrl(), because
         // we must not hit the server just to change the hash!
         setHash(getHref(), hash, true);
     }
 
     /**
      * Sets the hash portion of the location URL (the portion following the {@code #}).
      *
      * @param oldURL the old URL
      * @param hash the new hash portion of the location URL
      */
     public void setHash(final String oldURL, final String hash) {
         setHash(oldURL, hash, true);
     }
 
     /**
      * <span style="color:red">INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.</span><br>
      *
      * Sets the hash portion of the location URL (the portion following the {@code #}).
      *
      * @param oldURL the old URL
      * @param hash the new hash portion of the location URL
      * @param triggerHashChanged option to disable event triggering
      */
     public void setHash(final String oldURL, String hash, final boolean triggerHashChanged) {
         // IMPORTANT: This method must not call setUrl(), because
         // we must not hit the server just to change the hash!
         if (hash != null && !hash.isEmpty() && hash.charAt(0) == '#') {
             hash = hash.substring(1);
         }
         final boolean hasChanged = hash != null && !hash.equals(hash_);
         hash_ = hash;
 
         if (hasChanged) {
             final Window w = getWindow();
             final Page page = w.getWebWindow().getEnclosedPage();
             if (page != null) {
                 final WebRequest request = page.getWebResponse().getWebRequest();
                 request.setUrl(UrlUtils.toUrlSafe(getHref()));
             }
 
             if (triggerHashChanged) {
                 final Event event = new HashChangeEvent(w, Event.TYPE_HASH_CHANGE, oldURL, getHref());
                 w.executeEventLocally(event);
             }
         }
     }
 
     /**
      * Returns the hostname portion of the location URL.
      *
      * @return the hostname portion of the location URL
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/hostname">MDN Documentation</a>
      */
     public String getHostname() {
         return getUrl().getHost();
     }
 
     /**
      * Sets the hostname portion of the location URL.
      *
      * @param hostname the new hostname portion of the location URL
      * @throws Exception if an error occurs
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/hostname">MDN Documentation</a>
      */
     public void setHostname(final String hostname) throws Exception {
         setUrl(UrlUtils.getUrlWithNewHost(getUrl(), hostname));
     }
 
     /**
      * Returns the host portion of the location URL (the {@code [hostname]:[port]} portion).
      *
      * @return the host portion of the location URL
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/host">MDN Documentation</a>
      */
     public String getHost() {
         final URL url = getUrl();
         final int port = url.getPort();
         final String host = url.getHost();
 
         if (port == -1) {
             return host;
         }
         return host + ":" + port;
     }
 
     /**
      * Sets the host portion of the location URL (the {@code [hostname]:[port]} portion).
      *
      * @param host the new host portion of the location URL
      * @throws Exception if an error occurs
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/host">MDN Documentation</a>
      */
     public void setHost(final String host) throws Exception {
         final String hostname;
         final int port;
         final int index = host.indexOf(':');
         if (index == -1) {
             hostname = host;
             port = -1;
         }
         else {
             hostname = host.substring(0, index);
             port = Integer.parseInt(host.substring(index + 1));
         }
         final URL url = UrlUtils.getUrlWithNewHostAndPort(getUrl(), hostname, port);
         setUrl(url);
     }
 
     /**
      * Returns the pathname portion of the location URL.
      *
      * @return the pathname portion of the location URL
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/pathname">MDN Documentation</a>
      */
     public String getPathname() {
         if (UrlUtils.URL_ABOUT_BLANK == getUrl()) {
             return "blank";
         }
         return getUrl().getPath();
     }
 
     /**
      * Sets the pathname portion of the location URL.
      *
      * @param pathname the new pathname portion of the location URL
      * @throws Exception if an error occurs
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/pathname">MDN Documentation</a>
      */
     public void setPathname(final String pathname) throws Exception {
         setUrl(UrlUtils.getUrlWithNewPath(getUrl(), pathname));
     }
 
     /**
      * Returns the port portion of the location URL.
      *
      * @return the port portion of the location URL, or an empty string if no port is specified
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/port">MDN Documentation</a>
      */
     public String getPort() {
         final int port = getUrl().getPort();
         if (port == -1) {
             return "";
         }
         return Integer.toString(port);
     }
 
     /**
      * Sets the port portion of the location URL.
      *
      * @param port the new port portion of the location URL
      * @throws Exception if an error occurs
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/port">MDN Documentation</a>
      */
     public void setPort(final String port) throws Exception {
         setUrl(UrlUtils.getUrlWithNewPort(getUrl(), Integer.parseInt(port)));
     }
 
     /**
      * Returns the protocol portion of the location URL, including the trailing {@code :}.
      *
      * @return the protocol portion of the location URL
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/protocol">MDN Documentation</a>
      */
     public String getProtocol() {
         return getUrl().getProtocol() + ":";
     }
 
     /**
      * Sets the protocol portion of the location URL.
      *
      * @param protocol the new protocol portion of the location URL
      * @throws Exception if an error occurs
      * @see <a href="https://developer.mozilla.org/en-US/docs/Web/API/Location/protocol">MDN Documentation</a>
      */
     public void setProtocol(final String protocol) throws Exception {
         setUrl(UrlUtils.getUrlWithNewProtocol(getUrl(), protocol));
     }
 
     /**
      * Returns this location's current URL.
      *
      * @return this location's current URL
      */
     private URL getUrl() {
         return window_.getWebWindow().getEnclosedPage().getUrl();
     }
 
     /**
      * Sets this location's URL, triggering a server request and loading the resulting document
      * into this location's window.
      *
      * @param url this location's new URL
      * @throws IOException if there is a problem loading the new location
      */
     private void setUrl(final URL url) throws IOException {
         final WebWindow webWindow = window_.getWebWindow();
         final BrowserVersion browserVersion = webWindow.getWebClient().getBrowserVersion();
 
         final WebRequest webRequest = new WebRequest(url,
                 browserVersion.getHtmlAcceptHeader(), browserVersion.getAcceptEncodingHeader());
         webRequest.setRefererHeader(getUrl());
 
         webWindow.getWebClient().getPage(webWindow, webRequest);
     }
 
     /**
      * Returns the {@code origin} property.
      *
      * @return the {@code origin} property
      */
     public String getOrigin() {
         return getUrl().getProtocol() + "://" + getHost();
     }
 }