Package org.htmlunit.html

Class HtmlLink

  • All Implemented Interfaces:
    java.io.Serializable, java.lang.Cloneable, org.w3c.dom.Element, org.w3c.dom.Node
    public class HtmlLink
extends HtmlElement
    Wrapper for the HTML element "link". Note: This is not a clickable link, that one is an HtmlAnchor
    See Also:
    Serialized Form

    • Field Detail

      • TAG_NAME

        public static final java.lang.String TAG_NAME
        The HTML tag represented by this element.
        See Also:
        Constant Field Values

    • Method Detail

      • getCharsetAttribute

        public final java.lang.String getCharsetAttribute()
        Returns the value of the attribute charset. Refer to the HTML 4.01 documentation for details on the use of this attribute.
        Returns:
        the value of the attribute charset or an empty string if that attribute isn't defined.

      • getHrefAttribute

        public final java.lang.String getHrefAttribute()
        Returns the value of the attribute href. Refer to the HTML 4.01 documentation for details on the use of this attribute.
        Returns:
        the value of the attribute href or an empty string if that attribute isn't defined.

      • getHrefLangAttribute

        public final java.lang.String getHrefLangAttribute()
        Returns the value of the attribute hreflang. Refer to the HTML 4.01 documentation for details on the use of this attribute.
        Returns:
        the value of the attribute hreflang or an empty string if that attribute isn't defined.

      • getTypeAttribute

        public final java.lang.String getTypeAttribute()
        Returns the value of the attribute type. Refer to the HTML 4.01 documentation for details on the use of this attribute.
        Returns:
        the value of the attribute type or an empty string if that attribute isn't defined.

      • getRelAttribute

        public final java.lang.String getRelAttribute()
        Returns the value of the attribute rel. Refer to the HTML 4.01 documentation for details on the use of this attribute.
        Returns:
        the value of the attribute rel or an empty string if that attribute isn't defined.

      • getRevAttribute

        public final java.lang.String getRevAttribute()
        Returns the value of the attribute rev. Refer to the HTML 4.01 documentation for details on the use of this attribute.
        Returns:
        the value of the attribute rev or an empty string if that attribute isn't defined.

      • getMediaAttribute

        public final java.lang.String getMediaAttribute()
        Returns the value of the attribute media. Refer to the HTML 4.01 documentation for details on the use of this attribute.
        Returns:
        the value of the attribute media or an empty string if that attribute isn't defined.

      • getTargetAttribute

        public final java.lang.String getTargetAttribute()
        Returns the value of the attribute target. Refer to the HTML 4.01 documentation for details on the use of this attribute.
        Returns:
        the value of the attribute target or an empty string if that attribute isn't defined.

      • getWebResponse

        public WebResponse getWebResponse​(boolean downloadIfNeeded)
                           throws java.io.IOException
        POTENIAL PERFORMANCE KILLER - DOWNLOADS THE RESOURCE - USE AT YOUR OWN RISK.
        If the linked content is not already downloaded it triggers a download. Then it stores the response for later use.
        Parameters:
        downloadIfNeeded - indicates if a request should be performed this hasn't been done previously
        Returns:
        null if no download should be performed and when this wasn't already done; the response received when performing a request for the content referenced by this tag otherwise
        Throws:
        java.io.IOException - if an error occurs while downloading the content

      • getWebResponse

        public WebResponse getWebResponse​(boolean downloadIfNeeded,
                                  WebRequest request)
                           throws java.io.IOException
        INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
        If the linked content is not already downloaded it triggers a download. Then it stores the response for later use.
        Parameters:
        downloadIfNeeded - indicates if a request should be performed this hasn't been done previously
        request - the request; if null getWebRequest() is called to create one
        Returns:
        null if no download should be performed and when this wasn't already done; the response received when performing a request for the content referenced by this tag otherwise
        Throws:
        java.io.IOException - if an error occurs while downloading the content

      • getWebRequest

        public WebRequest getWebRequest()
                         throws java.net.MalformedURLException
        Returns the request which will allow us to retrieve the content referenced by the href attribute.
        Returns:
        the request which will allow us to retrieve the content referenced by the href attribute
        Throws:
        java.net.MalformedURLException - in case of problem resolving the URL

      • mayBeDisplayed

        public boolean mayBeDisplayed()
        Returns true if nodes of this type can ever be displayed, false otherwise. Examples of nodes that can never be displayed are <head>, <meta>, <script>, etc.
        Overrides:
        mayBeDisplayed in class DomNode
        Returns:
        true if nodes of this type can ever be displayed, false otherwise
        See Also:
        DomNode.isDisplayed()

      • onAllChildrenAddedToPage

        public void onAllChildrenAddedToPage​(boolean postponed)
        Lifecycle method invoked after a node and all its children have been added to a page, during parsing of the HTML. Intended to be overridden by nodes which need to perform custom logic after they and all their child nodes have been processed by the HTML parser. This method is not recursive, and the default implementation is empty, so there is no need to call super.onAllChildrenAddedToPage() if you implement this method.
        Overrides:
        onAllChildrenAddedToPage in class DomNode
        Parameters:
        postponed - whether to use PostponedAction or no

      • getSheet

        public org.htmlunit.css.CssStyleSheet getSheet()
        Returns the associated style sheet (only valid for links of type <link rel="stylesheet" type="text/css" href="..." />).
        Returns:
        the associated style sheet

      • isStyleSheetLink

        public boolean isStyleSheetLink()
        Returns:
        true if the rel attribute is 'stylesheet'

      • isActiveStyleSheetLink

        public boolean isActiveStyleSheetLink()

        Experimental API: May be changed in next release and may not yet work perfectly!

        Verifies if the provided node is a link node pointing to an active stylesheet.
        Returns:
        true if the provided node is a stylesheet link