Modifier and Type	Class and Description
public static class	ResultVerifier.SnippetRun Provides the test execution data.

Method Summary

Modifier and Type	Method and Description
public void	accept(ResultVerifier.SnippetRun the snippet execution data. The `SnippetRun` provides the actual snippet parameters, the execution result, or the `PolyglotException` thrown by the execution. If the snippet execution throws an `IllegalArgumentException`, it's converted to `PolyglotException`. snippetRun) Redeclares java.util.function.Consumer.accept. Performs a verification of a result of a snippet execution.
public static ResultVerifier	Returns: the default `ResultVerifier` getDefaultResultVerifier() Creates a default `ResultVerifier`.
public static ResultVerifier	Returns: the default `ResultVerifier` for `IdentityFunctionTest`. getIdentityFunctionDefaultResultVerifier() Creates a default `ResultVerifier` for the `IdentityFunctionTest`.

Inherited from java.util.function.Consumer:: andThen

Method Detail

accept back to summary

accept	back to summary
public void accept(ResultVerifier.SnippetRun snippetRun) throws PolyglotException Redeclares java.util.function.Consumer.accept. Performs a verification of a result of a snippet execution. The custom `ResultVerifier` overrides the default snippet execution verification. The default verification tests that the result type is in bounds specified by the `Snippet`. The custom `ResultVerifier` can be used to do additional checking of a result or an execution exception throwing `AssertionError` in case of failed assertion. The custom `ResultVerifier` can hide an expected execution exception. For example the division operator snippet may provide a custom `ResultVerifier` hiding the execution exception for division by zero. To propagate the execution exception the `ResultVerifier` should re-throw it. The `ResultVerifier` can be used to resolve problems in the `ErrorTypeTest` by making the `Snippet`'s parameter(s) more generic and restrict the required value in the verifier. Parameters snippetRun:ResultVerifier.SnippetRun the snippet execution data. The `SnippetRun` provides the actual snippet parameters, the execution result, or the `PolyglotException` thrown by the execution. If the snippet execution throws an `IllegalArgumentException`, it's converted to `PolyglotException`. Annotations @Override Exceptions PolyglotException: may propagate the `PolyglotException` from the snippetRun AssertionError: may throw an `AssertionError` as a result of a verification Since 0.30

public void accept(ResultVerifier.SnippetRun snippetRun) throws PolyglotException

Redeclares java.util.function.Consumer.accept.

Performs a verification of a result of a snippet execution. The custom ResultVerifier overrides the default snippet execution verification. The default verification tests that the result type is in bounds specified by the Snippet. The custom ResultVerifier can be used to do additional checking of a result or an execution exception throwing AssertionError in case of failed assertion. The custom ResultVerifier can hide an expected execution exception. For example the division operator snippet may provide a custom ResultVerifier hiding the execution exception for division by zero. To propagate the execution exception the ResultVerifier should re-throw it. The ResultVerifier can be used to resolve problems in the ErrorTypeTest by making the Snippet's parameter(s) more generic and restrict the required value in the verifier.

Parameters

snippetRun:ResultVerifier.SnippetRun: the snippet execution data. The SnippetRun provides the actual snippet parameters, the execution result, or the PolyglotException thrown by the execution. If the snippet execution throws an IllegalArgumentException, it's converted to PolyglotException.

Annotations

@Override

Exceptions

PolyglotException:: may propagate the PolyglotException from the snippetRun
AssertionError:: may throw an AssertionError as a result of a verification

Since

0.30

getDefaultResultVerifier back to summary

getDefaultResultVerifier	back to summary
public static ResultVerifier getDefaultResultVerifier() Creates a default `ResultVerifier`. The default `ResultVerifier` tests that the result type is in bounds specified by the `Snippet`. Returns:ResultVerifier the default `ResultVerifier` Since 19.0

public static ResultVerifier getDefaultResultVerifier()

Creates a default ResultVerifier. The default ResultVerifier tests that the result type is in bounds specified by the Snippet.

Returns:ResultVerifier: the default ResultVerifier
Since: 19.0

getIdentityFunctionDefaultResultVerifier back to summary

getIdentityFunctionDefaultResultVerifier	back to summary
public static ResultVerifier getIdentityFunctionDefaultResultVerifier() Creates a default `ResultVerifier` for the `IdentityFunctionTest`. The returned `ResultVerifier` tests that the identity function does not change the parameter type. Returns:ResultVerifier the default `ResultVerifier` for `IdentityFunctionTest`. Since 19.1.0

public static ResultVerifier getIdentityFunctionDefaultResultVerifier()

Creates a default ResultVerifier for the IdentityFunctionTest. The returned ResultVerifier tests that the identity function does not change the parameter type.

Returns:ResultVerifier: the default ResultVerifier for IdentityFunctionTest.
Since: 19.1.0

org.graalvm.polyglot.tck back to summary

public final Class ResultVerifier.SnippetRun

Class Inheritance

extends Object

java.lang.Object
org.graalvm.polyglot.tck.ResultVerifier.SnippetRun

Provides the test execution data.

Since: 0.30

Field Summary

Modifier and Type	Field and Description
private final PolyglotException	exception
private final List<? extends Value>	parameters
private final Value	result
private final Snippet	snippet

Constructor Summary

Access	Constructor and Description
private	SnippetRun(final Snippet snippet, final List<? extends Value> parameters, Value result, PolyglotException exception)

Method Summary

Modifier and Type	Method and Description
public static ResultVerifier.SnippetRun	Returns: the `SnippetRun` create(final Snippet the executed `Snippet` snippet, final List<? extends Value> the actual parameters of snippet execution parameters, final Value the result of snippet execution result) Creates a new `SnippetRun` for successful execution.
public static ResultVerifier.SnippetRun	Returns: the `SnippetRun` create(final Snippet the executed `Snippet` snippet, final List<? extends Value> the actual parameters of snippet execution parameters, final PolyglotException the `PolyglotException` thrown during snippet execution exception) Creates a new `SnippetRun` for failed execution.
public PolyglotException	Returns: the `PolyglotException` thrown during the execution or null in case of successful execution. getException() Returns the `PolyglotException` thrown during snippet execution.
public List<? extends Value>	Returns: the parameters getParameters() Returns the actual parameters of a snippet execution.
public Value	Returns: the result of a snippet execution or null in case of execution failure. getResult() Returns the result of a snippet execution.
pack-priv Snippet	getSnippet()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

exception	back to summary
private final PolyglotException exception

parameters	back to summary
private final List<? extends Value> parameters

result	back to summary
private final Value result

snippet	back to summary
private final Snippet snippet

Constructor Detail

SnippetRun	back to summary
private SnippetRun(final Snippet snippet, final List<? extends Value> parameters, Value result, PolyglotException exception)

Method Detail

create back to summary

create	back to summary
public static ResultVerifier.SnippetRun create(final Snippet snippet, final List<? extends Value> parameters, final Value result) Creates a new `SnippetRun` for successful execution. Parameters snippet:Snippet the executed `Snippet` parameters:List<? extends Value> the actual parameters of snippet execution result:Value the result of snippet execution Returns:ResultVerifier.SnippetRun the `SnippetRun` Since 0.30

public static ResultVerifier.SnippetRun create(final Snippet snippet, final List<? extends Value> parameters, final Value result)

Creates a new SnippetRun for successful execution.

Parameters

snippet:Snippet: the executed Snippet
parameters:List<? extends Value>: the actual parameters of snippet execution
result:Value: the result of snippet execution

Returns:ResultVerifier.SnippetRun

the SnippetRun

Since

0.30

create back to summary

create	back to summary
public static ResultVerifier.SnippetRun create(final Snippet snippet, final List<? extends Value> parameters, final PolyglotException exception) Creates a new `SnippetRun` for failed execution. Parameters snippet:Snippet the executed `Snippet` parameters:List<? extends Value> the actual parameters of snippet execution exception:PolyglotException the `PolyglotException` thrown during snippet execution Returns:ResultVerifier.SnippetRun the `SnippetRun` Since 0.30

public static ResultVerifier.SnippetRun create(final Snippet snippet, final List<? extends Value> parameters, final PolyglotException exception)

Creates a new SnippetRun for failed execution.

Parameters

snippet:Snippet: the executed Snippet
parameters:List<? extends Value>: the actual parameters of snippet execution
exception:PolyglotException: the PolyglotException thrown during snippet execution

Returns:ResultVerifier.SnippetRun

the SnippetRun

Since

0.30

getException back to summary

getException	back to summary
public PolyglotException getException() Returns the `PolyglotException` thrown during snippet execution. If the snippet execution throws an `IllegalArgumentException`, this exception is first converted to a `PolyglotException`, and the resulting `PolyglotException` is provided by this method. Returns:PolyglotException the `PolyglotException` thrown during the execution or null in case of successful execution. Since 0.30

public PolyglotException getException()

Returns the PolyglotException thrown during snippet execution. If the snippet execution throws an IllegalArgumentException, this exception is first converted to a PolyglotException, and the resulting PolyglotException is provided by this method.

Returns:PolyglotException: the PolyglotException thrown during the execution or null in case of successful execution.
Since: 0.30

getParameters	back to summary
public List<? extends Value> getParameters() Returns the actual parameters of a snippet execution. Returns:List<? extends Value> the parameters Since 0.30

getParameters

back to summary

public List<? extends Value> getParameters()

Returns the actual parameters of a snippet execution.

Returns:List<? extends Value>: the parameters
Since: 0.30

getResult	back to summary
public Value getResult() Returns the result of a snippet execution. Returns:Value the result of a snippet execution or null in case of execution failure. Since 0.30

getResult

back to summary

public Value getResult()

Returns the result of a snippet execution.

Returns:Value: the result of a snippet execution or null in case of execution failure.
Since: 0.30

getSnippet	back to summary
pack-priv Snippet getSnippet()

public Interface ResultVerifier

Nested and Inner Type Summary

Method Summary

Method Detail

public final Class ResultVerifier.SnippetRun

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail