graphql-php/tests/Executor/VariablesTest.php
2018-08-22 18:40:15 +07:00

922 lines
30 KiB
PHP

<?php
namespace GraphQL\Tests\Executor;
require_once __DIR__ . '/TestClasses.php';
use GraphQL\Error\Error;
use GraphQL\Executor\Executor;
use GraphQL\Language\Parser;
use GraphQL\Type\Schema;
use GraphQL\Type\Definition\InputObjectType;
use GraphQL\Type\Definition\ObjectType;
use GraphQL\Type\Definition\Type;
use PHPUnit\Framework\TestCase;
class VariablesTest extends TestCase
{
// Execute: Handles inputs
// Handles objects and nullability
/**
* @describe using inline structs
*/
public function testUsingInlineStructs()
{
// executes with complex input:
$result = $this->executeQuery('
{
fieldWithObjectInput(input: {a: "foo", b: ["bar"], c: "baz"})
}
');
$expected = [
'data' => [
'fieldWithObjectInput' => '{"a":"foo","b":["bar"],"c":"baz"}'
]
];
$this->assertEquals($expected, $result->toArray());
// properly parses single value to list:
$result = $this->executeQuery('
{
fieldWithObjectInput(input: {a: "foo", b: "bar", c: "baz"})
}
');
$expected = ['data' => ['fieldWithObjectInput' => '{"a":"foo","b":["bar"],"c":"baz"}']];
$this->assertEquals($expected, $result->toArray());
// properly parses null value to null
$result = $this->executeQuery('
{
fieldWithObjectInput(input: {a: null, b: null, c: "C", d: null})
}
');
$expected = ['data' => ['fieldWithObjectInput' => '{"a":null,"b":null,"c":"C","d":null}']];
$this->assertEquals($expected, $result->toArray());
// properly parses null value in list
$result = $this->executeQuery('
{
fieldWithObjectInput(input: {b: ["A",null,"C"], c: "C"})
}
');
$expected = ['data' => ['fieldWithObjectInput' => '{"b":["A",null,"C"],"c":"C"}']];
$this->assertEquals($expected, $result->toArray());
// does not use incorrect value
$result = $this->executeQuery('
{
fieldWithObjectInput(input: ["foo", "bar", "baz"])
}
');
$expected = [
'data' => ['fieldWithObjectInput' => null],
'errors' => [[
'message' => 'Argument "input" has invalid value ["foo", "bar", "baz"].',
'path' => ['fieldWithObjectInput'],
'locations' => [['line' => 3, 'column' => 39]]
]]
];
$this->assertArraySubset($expected, $result->toArray());
// properly runs parseLiteral on complex scalar types
$result = $this->executeQuery('
{
fieldWithObjectInput(input: {c: "foo", d: "SerializedValue"})
}
');
$this->assertEquals(
['data' => ['fieldWithObjectInput' => '{"c":"foo","d":"DeserializedValue"}']],
$result->toArray()
);
}
/**
* @describe using variables
*/
public function testUsingVariables()
{
$doc = '
query q($input:TestInputObject) {
fieldWithObjectInput(input: $input)
}
';
// executes with complex input:
$params = ['input' => ['a' => 'foo', 'b' => ['bar'], 'c' => 'baz']];
$result = $this->executeQuery($doc, $params);
$this->assertEquals(
['data' => ['fieldWithObjectInput' => '{"a":"foo","b":["bar"],"c":"baz"}']],
$result->toArray()
);
// uses default value when not provided:
$result = $this->executeQuery('
query ($input: TestInputObject = {a: "foo", b: ["bar"], c: "baz"}) {
fieldWithObjectInput(input: $input)
}
');
$expected = [
'data' => ['fieldWithObjectInput' => '{"a":"foo","b":["bar"],"c":"baz"}']
];
$this->assertEquals($expected, $result->toArray());
// properly parses single value to list:
$params = ['input' => ['a' => 'foo', 'b' => 'bar', 'c' => 'baz']];
$result = $this->executeQuery($doc, $params);
$this->assertEquals(
['data' => ['fieldWithObjectInput' => '{"a":"foo","b":["bar"],"c":"baz"}']],
$result->toArray()
);
// executes with complex scalar input:
$params = [ 'input' => [ 'c' => 'foo', 'd' => 'SerializedValue' ] ];
$result = $this->executeQuery($doc, $params);
$expected = [
'data' => [
'fieldWithObjectInput' => '{"c":"foo","d":"DeserializedValue"}'
]
];
$this->assertEquals($expected, $result->toArray());
// errors on null for nested non-null:
$params = ['input' => ['a' => 'foo', 'b' => 'bar', 'c' => null]];
$result = $this->executeQuery($doc, $params);
$expected = [
'errors' => [
[
'message' =>
'Variable "$input" got invalid value ' .
'{"a":"foo","b":"bar","c":null}; ' .
'Expected non-nullable type String! not to be null at value.c.',
'locations' => [['line' => 2, 'column' => 21]],
'category' => 'graphql'
]
]
];
$this->assertEquals($expected, $result->toArray());
// errors on incorrect type:
$params = [ 'input' => 'foo bar' ];
$result = $this->executeQuery($doc, $params);
$expected = [
'errors' => [
[
'message' =>
'Variable "$input" got invalid value "foo bar"; ' .
'Expected type TestInputObject to be an object.',
'locations' => [ [ 'line' => 2, 'column' => 21 ] ],
'category' => 'graphql',
]
]
];
$this->assertEquals($expected, $result->toArray());
// errors on omission of nested non-null:
$params = ['input' => ['a' => 'foo', 'b' => 'bar']];
$result = $this->executeQuery($doc, $params);
$expected = [
'errors' => [
[
'message' =>
'Variable "$input" got invalid value {"a":"foo","b":"bar"}; '.
'Field value.c of required type String! was not provided.',
'locations' => [['line' => 2, 'column' => 21]],
'category' => 'graphql',
]
]
];
$this->assertEquals($expected, $result->toArray());
// errors on deep nested errors and with many errors
$nestedDoc = '
query q($input: TestNestedInputObject) {
fieldWithNestedObjectInput(input: $input)
}
';
$params = [ 'input' => [ 'na' => [ 'a' => 'foo' ] ] ];
$result = $this->executeQuery($nestedDoc, $params);
$expected = [
'errors' => [
[
'message' =>
'Variable "$input" got invalid value {"na":{"a":"foo"}}; ' .
'Field value.na.c of required type String! was not provided.',
'locations' => [['line' => 2, 'column' => 19]],
'category' => 'graphql',
],
[
'message' =>
'Variable "$input" got invalid value {"na":{"a":"foo"}}; ' .
'Field value.nb of required type String! was not provided.',
'locations' => [['line' => 2, 'column' => 19]],
'category' => 'graphql',
]
]
];
$this->assertEquals($expected, $result->toArray());
// errors on addition of unknown input field
$params = ['input' => [ 'a' => 'foo', 'b' => 'bar', 'c' => 'baz', 'extra' => 'dog' ]];
$result = $this->executeQuery($doc, $params);
$expected = [
'errors' => [
[
'message' =>
'Variable "$input" got invalid value ' .
'{"a":"foo","b":"bar","c":"baz","extra":"dog"}; ' .
'Field "extra" is not defined by type TestInputObject.',
'locations' => [['line' => 2, 'column' => 21]],
'category' => 'graphql',
]
]
];
$this->assertEquals($expected, $result->toArray());
}
// Describe: Handles nullable scalars
/**
* @it allows nullable inputs to be omitted
*/
public function testAllowsNullableInputsToBeOmitted()
{
$result = $this->executeQuery('
{
fieldWithNullableStringInput
}
');
$expected = [
'data' => ['fieldWithNullableStringInput' => null]
];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows nullable inputs to be omitted in a variable
*/
public function testAllowsNullableInputsToBeOmittedInAVariable()
{
$result = $this->executeQuery('
query SetsNullable($value: String) {
fieldWithNullableStringInput(input: $value)
}
');
$expected = ['data' => ['fieldWithNullableStringInput' => null]];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows nullable inputs to be omitted in an unlisted variable
*/
public function testAllowsNullableInputsToBeOmittedInAnUnlistedVariable()
{
$result = $this->executeQuery('
query SetsNullable {
fieldWithNullableStringInput(input: $value)
}
');
$expected = ['data' => ['fieldWithNullableStringInput' => null]];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows nullable inputs to be set to null in a variable
*/
public function testAllowsNullableInputsToBeSetToNullInAVariable()
{
$result = $this->executeQuery('
query SetsNullable($value: String) {
fieldWithNullableStringInput(input: $value)
}
');
$expected = ['data' => ['fieldWithNullableStringInput' => null]];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows nullable inputs to be set to a value in a variable
*/
public function testAllowsNullableInputsToBeSetToAValueInAVariable()
{
$doc = '
query SetsNullable($value: String) {
fieldWithNullableStringInput(input: $value)
}
';
$result = $this->executeQuery($doc, ['value' => 'a']);
$expected = ['data' => ['fieldWithNullableStringInput' => '"a"']];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows nullable inputs to be set to a value directly
*/
public function testAllowsNullableInputsToBeSetToAValueDirectly()
{
$result = $this->executeQuery('
{
fieldWithNullableStringInput(input: "a")
}
');
$expected = ['data' => ['fieldWithNullableStringInput' => '"a"']];
$this->assertEquals($expected, $result->toArray());
}
// Describe: Handles non-nullable scalars
/**
* @it allows non-nullable inputs to be omitted given a default
*/
public function testAllowsNonNullableInputsToBeOmittedGivenADefault()
{
$result = $this->executeQuery('
query SetsNonNullable($value: String = "default") {
fieldWithNonNullableStringInput(input: $value)
}
');
$expected = [
'data' => ['fieldWithNonNullableStringInput' => '"default"']
];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it does not allow non-nullable inputs to be omitted in a variable
*/
public function testDoesntAllowNonNullableInputsToBeOmittedInAVariable()
{
$result = $this->executeQuery('
query SetsNonNullable($value: String!) {
fieldWithNonNullableStringInput(input: $value)
}
');
$expected = [
'errors' => [
[
'message' => 'Variable "$value" of required type "String!" was not provided.',
'locations' => [['line' => 2, 'column' => 31]],
'category' => 'graphql'
]
]
];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it does not allow non-nullable inputs to be set to null in a variable
*/
public function testDoesNotAllowNonNullableInputsToBeSetToNullInAVariable()
{
$doc = '
query SetsNonNullable($value: String!) {
fieldWithNonNullableStringInput(input: $value)
}
';
$result = $this->executeQuery($doc, ['value' => null]);
$expected = [
'errors' => [
[
'message' =>
'Variable "$value" got invalid value null; ' .
'Expected non-nullable type String! not to be null.',
'locations' => [['line' => 2, 'column' => 31]],
'category' => 'graphql',
]
]
];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows non-nullable inputs to be set to a value in a variable
*/
public function testAllowsNonNullableInputsToBeSetToAValueInAVariable()
{
$doc = '
query SetsNonNullable($value: String!) {
fieldWithNonNullableStringInput(input: $value)
}
';
$result = $this->executeQuery($doc, ['value' => 'a']);
$expected = ['data' => ['fieldWithNonNullableStringInput' => '"a"']];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows non-nullable inputs to be set to a value directly
*/
public function testAllowsNonNullableInputsToBeSetToAValueDirectly()
{
$result = $this->executeQuery('
{
fieldWithNonNullableStringInput(input: "a")
}
');
$expected = ['data' => ['fieldWithNonNullableStringInput' => '"a"']];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it reports error for missing non-nullable inputs
*/
public function testReportsErrorForMissingNonNullableInputs()
{
$result = $this->executeQuery('
{
fieldWithNonNullableStringInput
}
');
$expected = [
'data' => ['fieldWithNonNullableStringInput' => null],
'errors' => [[
'message' => 'Argument "input" of required type "String!" was not provided.',
'locations' => [ [ 'line' => 3, 'column' => 9 ] ],
'path' => [ 'fieldWithNonNullableStringInput' ],
'category' => 'graphql',
]]
];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it reports error for array passed into string input
*/
public function testReportsErrorForArrayPassedIntoStringInput()
{
$doc = '
query SetsNonNullable($value: String!) {
fieldWithNonNullableStringInput(input: $value)
}
';
$variables = ['value' => [1, 2, 3]];
$result = $this->executeQuery($doc, $variables);
$expected = [
'errors' => [[
'message' =>
'Variable "$value" got invalid value [1,2,3]; Expected type ' .
'String; String cannot represent an array value: [1,2,3]',
'category' => 'graphql',
'locations' => [
['line' => 2, 'column' => 31]
]
]]
];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it serializing an array via GraphQLString throws TypeError
*/
public function testSerializingAnArrayViaGraphQLStringThrowsTypeError()
{
$this->expectException(Error::class);
$this->expectExceptionMessage('String cannot represent non scalar value: [1,2,3]');
Type::string()->serialize([1, 2, 3]);
}
/**
* @it reports error for non-provided variables for non-nullable inputs
*/
public function testReportsErrorForNonProvidedVariablesForNonNullableInputs()
{
// Note: this test would typically fail validation before encountering
// this execution error, however for queries which previously validated
// and are being run against a new schema which have introduced a breaking
// change to make a formerly non-required argument required, this asserts
// failure before allowing the underlying code to receive a non-null value.
$result = $this->executeQuery('
{
fieldWithNonNullableStringInput(input: $foo)
}
');
$expected = [
'data' => ['fieldWithNonNullableStringInput' => null],
'errors' => [[
'message' =>
'Argument "input" of required type "String!" was provided the ' .
'variable "$foo" which was not provided a runtime value.',
'locations' => [['line' => 3, 'column' => 48]],
'path' => ['fieldWithNonNullableStringInput'],
'category' => 'graphql',
]]
];
$this->assertEquals($expected, $result->toArray());
}
// Describe: Handles lists and nullability
/**
* @it allows lists to be null
*/
public function testAllowsListsToBeNull()
{
$doc = '
query q($input:[String]) {
list(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => null]);
$expected = ['data' => ['list' => null]];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows lists to contain values
*/
public function testAllowsListsToContainValues()
{
$doc = '
query q($input:[String]) {
list(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => ['A']]);
$expected = ['data' => ['list' => '["A"]']];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows lists to contain null
*/
public function testAllowsListsToContainNull()
{
$doc = '
query q($input:[String]) {
list(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => ['A',null,'B']]);
$expected = ['data' => ['list' => '["A",null,"B"]']];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it does not allow non-null lists to be null
*/
public function testDoesNotAllowNonNullListsToBeNull()
{
$doc = '
query q($input:[String]!) {
nnList(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => null]);
$expected = [
'errors' => [
[
'message' =>
'Variable "$input" got invalid value null; ' .
'Expected non-nullable type [String]! not to be null.',
'locations' => [['line' => 2, 'column' => 17]],
'category' => 'graphql',
]
]
];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows non-null lists to contain values
*/
public function testAllowsNonNullListsToContainValues()
{
$doc = '
query q($input:[String]!) {
nnList(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => ['A']]);
$expected = ['data' => ['nnList' => '["A"]']];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows non-null lists to contain null
*/
public function testAllowsNonNullListsToContainNull()
{
$doc = '
query q($input:[String]!) {
nnList(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => ['A',null,'B']]);
$expected = ['data' => ['nnList' => '["A",null,"B"]']];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows lists of non-nulls to be null
*/
public function testAllowsListsOfNonNullsToBeNull()
{
$doc = '
query q($input:[String!]) {
listNN(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => null]);
$expected = ['data' => ['listNN' => null]];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows lists of non-nulls to contain values
*/
public function testAllowsListsOfNonNullsToContainValues()
{
$doc = '
query q($input:[String!]) {
listNN(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => ['A']]);
$expected = ['data' => ['listNN' => '["A"]']];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it does not allow lists of non-nulls to contain null
*/
public function testDoesNotAllowListsOfNonNullsToContainNull()
{
$doc = '
query q($input:[String!]) {
listNN(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => ['A', null, 'B']]);
$expected = [
'errors' => [
[
'message' =>
'Variable "$input" got invalid value ["A",null,"B"]; ' .
'Expected non-nullable type String! not to be null at value[1].',
'locations' => [ ['line' => 2, 'column' => 17] ],
'category' => 'graphql',
]
]
];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it does not allow non-null lists of non-nulls to be null
*/
public function testDoesNotAllowNonNullListsOfNonNullsToBeNull()
{
$doc = '
query q($input:[String!]!) {
nnListNN(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => null]);
$expected = [
'errors' => [
[
'message' =>
'Variable "$input" got invalid value null; ' .
'Expected non-nullable type [String!]! not to be null.',
'locations' => [ ['line' => 2, 'column' => 17] ],
'category' => 'graphql',
]
]
];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it allows non-null lists of non-nulls to contain values
*/
public function testAllowsNonNullListsOfNonNullsToContainValues()
{
$doc = '
query q($input:[String!]!) {
nnListNN(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => ['A']]);
$expected = ['data' => ['nnListNN' => '["A"]']];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it does not allow non-null lists of non-nulls to contain null
*/
public function testDoesNotAllowNonNullListsOfNonNullsToContainNull()
{
$doc = '
query q($input:[String!]!) {
nnListNN(input: $input)
}
';
$result = $this->executeQuery($doc, ['input' => ['A', null, 'B']]);
$expected = [
'errors' => [
[
'message' =>
'Variable "$input" got invalid value ["A",null,"B"]; ' .
'Expected non-nullable type String! not to be null at value[1].',
'locations' => [ ['line' => 2, 'column' => 17] ],
'category' => 'graphql',
]
]
];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it does not allow invalid types to be used as values
*/
public function testDoesNotAllowInvalidTypesToBeUsedAsValues()
{
$doc = '
query q($input: TestType!) {
fieldWithObjectInput(input: $input)
}
';
$vars = [ 'input' => [ 'list' => [ 'A', 'B' ] ] ];
$result = $this->executeQuery($doc, $vars);
$expected = [
'errors' => [
[
'message' =>
'Variable "$input" expected value of type "TestType!" which cannot ' .
'be used as an input type.',
'locations' => [['line' => 2, 'column' => 25]],
'category' => 'graphql',
]
]
];
$this->assertEquals($expected, $result->toArray());
}
/**
* @it does not allow unknown types to be used as values
*/
public function testDoesNotAllowUnknownTypesToBeUsedAsValues()
{
$doc = '
query q($input: UnknownType!) {
fieldWithObjectInput(input: $input)
}
';
$vars = ['input' => 'whoknows'];
$result = $this->executeQuery($doc, $vars);
$expected = [
'errors' => [
[
'message' =>
'Variable "$input" expected value of type "UnknownType!" which ' .
'cannot be used as an input type.',
'locations' => [['line' => 2, 'column' => 25]],
'category' => 'graphql',
]
]
];
$this->assertEquals($expected, $result->toArray());
}
// Describe: Execute: Uses argument default values
/**
* @it when no argument provided
*/
public function testWhenNoArgumentProvided()
{
$result = $this->executeQuery('{
fieldWithDefaultArgumentValue
}');
$this->assertEquals(
['data' => ['fieldWithDefaultArgumentValue' => '"Hello World"']],
$result->toArray()
);
}
/**
* @it when omitted variable provided
*/
public function testWhenOmittedVariableProvided()
{
$result = $this->executeQuery('query optionalVariable($optional: String) {
fieldWithDefaultArgumentValue(input: $optional)
}');
$this->assertEquals(
['data' => ['fieldWithDefaultArgumentValue' => '"Hello World"']],
$result->toArray()
);
}
/**
* @it not when argument cannot be coerced
*/
public function testNotWhenArgumentCannotBeCoerced()
{
$result = $this->executeQuery('{
fieldWithDefaultArgumentValue(input: WRONG_TYPE)
}');
$expected = [
'data' => ['fieldWithDefaultArgumentValue' => null],
'errors' => [[
'message' =>
'Argument "input" has invalid value WRONG_TYPE.',
'locations' => [ [ 'line' => 2, 'column' => 50 ] ],
'path' => [ 'fieldWithDefaultArgumentValue' ],
'category' => 'graphql',
]]
];
$this->assertEquals($expected, $result->toArray());
}
public function schema()
{
$ComplexScalarType = ComplexScalar::create();
$TestInputObject = new InputObjectType([
'name' => 'TestInputObject',
'fields' => [
'a' => ['type' => Type::string()],
'b' => ['type' => Type::listOf(Type::string())],
'c' => ['type' => Type::nonNull(Type::string())],
'd' => ['type' => $ComplexScalarType],
]
]);
$TestNestedInputObject = new InputObjectType([
'name' => 'TestNestedInputObject',
'fields' => [
'na' => [ 'type' => Type::nonNull($TestInputObject) ],
'nb' => [ 'type' => Type::nonNull(Type::string()) ],
],
]);
$TestType = new ObjectType([
'name' => 'TestType',
'fields' => [
'fieldWithObjectInput' => $this->fieldWithInputArg(['type' => $TestInputObject]),
'fieldWithNullableStringInput' => $this->fieldWithInputArg(['type' => Type::string()]),
'fieldWithNonNullableStringInput' => $this->fieldWithInputArg(['type' => Type::nonNull(Type::string())]),
'fieldWithDefaultArgumentValue' => $this->fieldWithInputArg([
'type' => Type::string(),
'defaultValue' => 'Hello World',
]),
'fieldWithNestedInputObject' => $this->fieldWithInputArg([
'type' => $TestNestedInputObject,
'defaultValue' => 'Hello World'
]),
'list' => $this->fieldWithInputArg(['type' => Type::listOf(Type::string())]),
'nnList' => $this->fieldWithInputArg(['type' => Type::nonNull(Type::listOf(Type::string()))]),
'listNN' => $this->fieldWithInputArg(['type' => Type::listOf(Type::nonNull(Type::string()))]),
'nnListNN' => $this->fieldWithInputArg(['type' => Type::nonNull(Type::listOf(Type::nonNull(Type::string())))]),
]
]);
$schema = new Schema(['query' => $TestType]);
return $schema;
}
private function fieldWithInputArg($inputArg)
{
return [
'type' => Type::string(),
'args' => ['input' => $inputArg],
'resolve' => function ($_, $args) {
if (isset($args['input'])) {
return json_encode($args['input']);
}
return null;
},
];
}
private function executeQuery($query, $variableValues = null)
{
$document = Parser::parse($query);
return Executor::execute($this->schema(), $document, null, null, $variableValues);
}
}