Class: GraphQL::Schema::Directive::Feature

Inherits:

GraphQL::Schema::Directive

Object
Member
GraphQL::Schema::Directive
GraphQL::Schema::Directive::Feature

show all

Defined in:: lib/graphql/schema/directive/feature.rb

Overview

An example directive to show how you might interact with the runtime.

This directive might be used along with a server-side feature flag system like Flipper.

With that system, you could use this directive to exclude parts of a query if the current viewer doesn’t have certain flags enabled. (So, this flag would be for internal clients, like your iOS app, not third-party API clients.)

To use it, you have to implement .enabled?, for example:

Examples:

Implementing the Feature directive

# app/graphql/directives/feature.rb
class Directives::Feature < GraphQL::Schema::Directive::Feature
  def self.enabled?(flag_name, _obj, context)
    # Translate some GraphQL data for Ruby:
    flag_key = flag_name.underscore
    current_user = context[:viewer]
    # Check the feature flag however your app does it:
    MyFeatureFlags.enabled?(current_user, flag_key)
  end
end

Flagging a part of the query

viewer {
  # This field only runs if `.enabled?("recommendationEngine", obj, context)`
  # returns true. Otherwise, it's treated as if it didn't exist.
  recommendations @feature(flag: "recommendationEngine") {
    name
    rating
  }
}

Constant Summary

Instance Attribute Summary

Attributes inherited from GraphQL::Schema::Directive

#arguments, #owner

Class Method Summary collapse

.enabled?(flag_name, object, context) ⇒ Boolean
Override this method in your app’s subclass of this directive.
.include?(object, arguments, context) ⇒ Boolean
Implement the Directive API.

Methods inherited from GraphQL::Schema::Directive

default_directive, default_directive?, default_graphql_name, #graphql_name, #initialize, locations, on_field?, on_fragment?, on_operation?, path, repeatable, repeatable?, resolve, resolve_each, static_include?

Methods included from Member::HasArguments

#add_argument, #all_argument_definitions, #argument, #argument_class, #arguments, #arguments_statically_coercible?, #coerce_arguments, #get_argument, #own_arguments, #remove_argument, #validate_directive_argument

Methods included from Member::BaseDSLMethods

#accessible?, #authorized?, #default_graphql_name, #description, #graphql_name, #introspection, #introspection?, #mutation, #name, #overridden_graphql_name, #visible?

Methods included from Member::BaseDSLMethods::ConfigurationExtension

#inherited

Methods included from Member::TypeSystemHelpers

#kind, #list?, #non_null?, #to_list_type, #to_non_null_type, #to_type_signature

Methods included from Member::Scoped

#scope_items

Methods included from Member::RelayShortcuts

#connection_type, #connection_type_class, #edge_type, #edge_type_class

Methods included from Member::HasPath

#path

Methods included from Member::HasAstNode

#ast_node

Methods included from Member::HasDirectives

#directive, #directives, #remove_directive

Constructor Details

This class inherits a constructor from GraphQL::Schema::Directive

Class Method Details

.enabled?(flag_name, object, context) ⇒ `Boolean`

Override this method in your app’s subclass of this directive.

Parameters:

flag_name (String) —
The client-provided string of a feature to check
object (GraphQL::Schema::Objct) —
The currently-evaluated GraphQL object instance
context (GraphQL::Query::Context)

Returns:

(Boolean) —
If truthy, execution will continue

Raises:

(GraphQL::RequiredImplementationMissingError)



60
61
62

# File 'lib/graphql/schema/directive/feature.rb', line 60

def self.enabled?(flag_name, object, context)
  raise GraphQL::RequiredImplementationMissingError, "Implement `.enabled?(flag_name, object, context)` to return true or false for the feature flag (#{flag_name.inspect})"
end

.include?(object, arguments, context) ⇒ `Boolean`

Implement the Directive API