001package Torello.Browser;
002
003import Torello.Browser.CDPTypes;
004import Torello.Java.UnreachableError;
005
006/**
007 * Indicates that the class {@link CDPTypes} has received a Java {@code String} which isn't among 
008 * the recognized <B STYLE='color:red;'>"Computed Type as String"</B> types.  
009 * 
010 * <BR /><BR /><DIV CLASS=JDHint>
011 * Generally, the class {@link CDPTypes} is intended for internal &amp; proprietary use only.  It 
012 * really doesn't need to be invoked by external, user code.  It remains public because, indeed, 
013 * there are classes which reside in packages other than {@code 'Torello.Browser'} invoke it.  As a
014 * result, it must be declared public.  And because JavaDoc publishes anything which has the 
015 * reserved keyword 'public', you the end user can see the methods &amp; fields.
016 * 
017 * <BR /><BR />
018 * ⚠️ Class {@link CDPTypes} really is intended strictly for Java-HTML proprietary invocations.  
019 * Because that class is declared 'public', {@link UnreachableError} was replaced by this error.
020 * </DIV>
021 * 
022 * @see CDPTypes#ctasToByte(String)
023 * @see CDPTypes#ctasToByte(String, boolean, boolean)
024 */
025public class UnrecognizedCTASError extends Error
026{
027    /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUIDEX> */
028    protected static final long serialVersionUID = 1L;
029
030    /** Constructs a {@code UnrecognizedCTASError} with no detail message. */
031    public UnrecognizedCTASError()
032    { super(); }
033
034    /**
035     * Constructs a {@code UnrecognizedCTASError} using the erroneous {@code 'CTAS'} value as the
036     * detail message.
037     * 
038     * @param CTAS The erroneous value used for <B SYTLE='color:red;'>"Computed Type as String"</B>
039     * (CTAS)
040     *
041     * @see CDPTypes#ctasToByte(String)
042     * @see CDPTypes#ctasToByte(String, boolean, boolean)
043     */
044    public UnrecognizedCTASError(String CTAS)
045    {
046        super(
047            "The following String was passed to class CDPTypes:" + '\n' +
048            CTAS + '\n' +
049            "This is not a valid parameter-value for the parameter 'CTAS'."
050        );
051    }
052}