Class ProxyObjectType
- java.lang.Object
-
- com.google.javascript.rhino.jstype.JSType
-
- com.google.javascript.rhino.jstype.ObjectType
-
- com.google.javascript.rhino.jstype.ProxyObjectType
-
- Direct Known Subclasses:
NamedType,TemplateType,TemplatizedType
public class ProxyObjectType extends ObjectType
An object type which uses composition to delegate all calls.- See Also:
NamedType,TemplatizedType
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.google.javascript.rhino.jstype.JSType
JSType.HasPropertyKind, JSType.Nullability, JSType.SubtypingMode, JSType.TypePair
-
-
Field Summary
-
Fields inherited from class com.google.javascript.rhino.jstype.JSType
templateTypeMap
-
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description booleancanBeCalled()This predicate is used to test whether a given type can be used as the 'function' in a function call.JSTypecollapseUnion()Gets the least supertype of this that's not a union.protected JSTypefindPropertyTypeWithoutConsideringTemplateTypes(java.lang.String propertyName)Looks up a property on this type, but without properly replacing any templates in the result.FunctionTypegetConstructor()Gets this object's constructor.java.lang.Iterable<ObjectType>getCtorExtendedInterfaces()Gets the interfaces extended by the interface associated with this type.java.lang.Iterable<ObjectType>getCtorImplementedInterfaces()Gets the interfaces implemented by the ctor associated with this type.ObjectTypegetImplicitPrototype()Gets the implicit prototype (a.k.a.JSDocInfogetJSDocInfo()Gets the docInfo for this type.FunctionTypegetOwnerFunction()JSType.HasPropertyKindgetPropertyKind(java.lang.String propertyName, boolean autobox)Checks whether the property is present on the object.java.lang.StringgetReferenceName()Gets the reference name for this object.intgetTemplateParamCount()Return the number of template parameters declared for this type.TemplateTypeMapgetTemplateTypeMap()Returns the template type map associated with this type.com.google.common.collect.ImmutableList<JSType>getTemplateTypes()Gets the declared default element type.JSTypegetTypeOfThis()booleanhasAnyTemplateTypesInternal()booleanisAllType()booleanisCheckedUnknownType()booleanisConstructor()Whether this type is aFunctionTypethat is a constructor or a named type that points to such a type.booleanisDict()Returns true iffthiscan be adict.booleanisInstanceType()Whether this type is an Instance object of some constructor.booleanisInterface()Whether this type is aFunctionTypethat is an interface or a named type that points to such a type.booleanisNativeObjectType()Whether this is a built-in object.booleanisNominalType()Whether this type is a nominal type (a named instance object or a named enum).booleanisNoObjectType()booleanisNoResolvedType()booleanisNoType()booleanisNullable()Tests whether this type is nullable.booleanisOrdinaryFunction()Whether this type is aFunctionTypethat is an ordinary function (i.e.booleanisStruct()Returns true iffthiscan be astruct.booleanisStructuralType()booleanisUnknownType()We treat this as the unknown type if any of its implicit prototype properties is unknown.booleanisVoidable()Tests whether this type is voidable.booleanloosenTypecheckingDueToForwardReferencedSupertype()During type definition, was one of the supertypes of this type a forward reference?voidmatchConstraint(JSType constraint)Modify this type so that it matches the specified type.booleanmatchesNumberContext()This predicate is used to test whether a given type can appear in a numeric context, such as an operand of a multiply operator.booleanmatchesObjectContext()This predicate is used to test whether a given type can appear in anObjectcontext, such as the expression in a with statement.booleanmatchesStringContext()This predicate is used to test whether a given type can appear in aStringcontext, such as an operand of a string concat (+) operator.booleanmatchesSymbolContext()This predicate is used to test whether a given type can appear in asymbolcontext such as property access.booleanremoveProperty(java.lang.String name)Removes the declared or inferred property from this ObjectType.voidsetJSDocInfo(JSDocInfo info)Sets the docInfo for this type from the givenJSDocInfo.voidsetPropertyJSDocInfo(java.lang.String propertyName, JSDocInfo info)Sets the docInfo for the specified property from theJSDocInfoon its definition.booleansetValidator(com.google.common.base.Predicate<JSType> validator)Certain types have constraints on them at resolution-time.TernaryValuetestForEquality(JSType that)Comparesthisandthat.EnumElementTypetoMaybeEnumElementType()Downcasts this to an EnumElementType, or returns null if this is not an EnumElementType.EnumTypetoMaybeEnumType()Downcasts this to an EnumType, or returns null if this is not an EnumType.FunctionTypetoMaybeFunctionType()Downcasts this to a FunctionType, or returns null if this is not a function.RecordTypetoMaybeRecordType()Downcasts this to a RecordType, or returns null if this is not a RecordType.TemplateTypetoMaybeTemplateType()Downcasts this to a TemplateType, or returns null if this is not a template type.TemplatizedTypetoMaybeTemplatizedType()Downcasts this to a TemplatizedType, or returns null if this is not a templatized type.UnionTypetoMaybeUnionType()Downcasts this to a UnionType, or returns null if this is not a UnionType.<T> Tvisit(Visitor<T> visitor)Visit this type with the given visitor.<T> TvisitReferenceType(Visitor<T> visitor)-
Methods inherited from class com.google.javascript.rhino.jstype.ObjectType
cast, clearCachedValues, createDelegateSuffix, defineDeclaredProperty, defineInferredProperty, defineSynthesizedProperty, findClosestDefinition, getClosestDefiningType, getDisplayName, getEnumeratedTypeOfEnumObject, getImplicitPrototypeChain, getNormalizedReferenceName, getOwnPropertyDefSite, getOwnPropertyJSDocInfo, getOwnPropertyKind, getOwnPropertyNames, getOwnSlot, getPossibleToBooleanOutcomes, getPropertiesCount, getPropertyDefSite, getPropertyJSDocInfo, getPropertyNames, getPropertyNode, getPropertyType, getPropertyTypeMap, getRawType, getSlot, getSuperClassConstructor, hasCachedValues, hasOwnProperty, hasReferenceName, isFunctionPrototypeType, isObject, isPropertyInExterns, isPropertyTypeDeclared, isPropertyTypeInferred, setPropertyNode
-
Methods inherited from class com.google.javascript.rhino.jstype.JSType
areIdentical, areSimilar, assertFunctionType, assertObjectType, autobox, autoboxesTo, canCastTo, canTestForEqualityWith, canTestForShallowEqualityWith, containsReferenceAncestor, dereference, differsFrom, equals, findPropertyType, getEnumeratedTypeOfEnumElement, getGreatestSubtype, getLeastSupertype, getPropertyKind, getRestrictedTypeGivenOutcome, getTypeParameters, getTypesUnderEquality, getTypesUnderInequality, getTypesUnderShallowEquality, getTypesUnderShallowInequality, getUnionMembers, hasAnyTemplateTypes, hasDisplayName, hashCode, hasProperty, isArrayType, isBigIntObjectType, isBigIntOrNumber, isBigIntValueType, isBooleanObjectType, isBooleanValueType, isBoxableScalar, isDateType, isEmptyType, isEnumElementType, isEnumType, isExplicitlyVoidable, isFunctionType, isGlobalThisType, isLiteralObject, isNamedType, isNominalConstructorOrInterface, isNullType, isNumber, isNumberObjectType, isNumberValueType, isObjectType, isOnlyBigInt, isRawTypeOfTemplatizedType, isRecordType, isRegexpType, isResolved, isSomeUnknownType, isString, isStringObjectType, isStringValueType, isStructuralInterface, isSubtype, isSubtype, isSubtypeOf, isSubtypeOf, isSubtypeWithoutStructuralTyping, isSuccessfullyResolved, isSymbol, isSymbolObjectType, isSymbolValueType, isTemplateType, isTemplatizedType, isUnionType, isUnresolved, isUnresolvedOrResolvedUnknown, isUnsuccessfullyResolved, isVoidType, mergeSupertypeTemplateTypes, resolve, restrictByNotNull, restrictByNotNullOrUndefined, restrictByNotUndefined, toAnnotationString, toMaybeFunctionType, toMaybeNamedType, toMaybeObjectType, toObjectType, toString
-
-
-
-
Method Detail
-
getPropertyKind
public final JSType.HasPropertyKind getPropertyKind(java.lang.String propertyName, boolean autobox)
Description copied from class:JSTypeChecks whether the property is present on the object.- Overrides:
getPropertyKindin classObjectType- Parameters:
propertyName- The property name.autobox- Whether to check for the presents on an autoboxed type
-
loosenTypecheckingDueToForwardReferencedSupertype
public final boolean loosenTypecheckingDueToForwardReferencedSupertype()
Description copied from class:JSTypeDuring type definition, was one of the supertypes of this type a forward reference?This is a hack to work around the fact that inheritance chains and template types aren't wired up correctly when this happens, which causes various false positives in checks. The known bugs associated are b/145145406, b/144327372, and b/132980305.
This method should only be used to suppress potential false positives caused by one of the above bugs, in the case where we think suppressing typechecking is preferable to emitting a false positive.
- Overrides:
loosenTypecheckingDueToForwardReferencedSupertypein classJSType
-
setValidator
public boolean setValidator(com.google.common.base.Predicate<JSType> validator)
Description copied from class:JSTypeCertain types have constraints on them at resolution-time. For example, a type in an@extendsannotation must be an object. Clients should inject a validator that emits a warning if the type does not validate, and return false.- Overrides:
setValidatorin classJSType
-
getReferenceName
public java.lang.String getReferenceName()
Description copied from class:ObjectTypeGets the reference name for this object. This includes named types like constructors, prototypes, and enums. It notably does not include literal types like strings and booleans and structural types.Returning an empty string means something different than returning null. An empty string may indicate an anonymous constructor, which we treat differently than a literal type without a reference name. e.g. in
InstanceObjectType.appendTo(TypeStringBuilder)- Specified by:
getReferenceNamein classObjectType- Returns:
- the object's name or
nullif this is an anonymous object
-
matchesNumberContext
public final boolean matchesNumberContext()
Description copied from class:JSTypeThis predicate is used to test whether a given type can appear in a numeric context, such as an operand of a multiply operator.- Overrides:
matchesNumberContextin classJSType
-
matchesStringContext
public final boolean matchesStringContext()
Description copied from class:JSTypeThis predicate is used to test whether a given type can appear in aStringcontext, such as an operand of a string concat (+) operator. All types have at least the potential for converting toString. When we add externally defined types, such as a browser OM, we may choose to add types that do not automatically convert toString.- Overrides:
matchesStringContextin classJSType
-
matchesSymbolContext
public final boolean matchesSymbolContext()
Description copied from class:JSTypeThis predicate is used to test whether a given type can appear in asymbolcontext such as property access.- Overrides:
matchesSymbolContextin classJSType
-
matchesObjectContext
public final boolean matchesObjectContext()
Description copied from class:JSTypeThis predicate is used to test whether a given type can appear in anObjectcontext, such as the expression in a with statement. Most types we will encounter, except notablynull, have at least the potential for converting toObject. Host defined objects can get peculiar.- Overrides:
matchesObjectContextin classJSType
-
canBeCalled
public final boolean canBeCalled()
Description copied from class:JSTypeThis predicate is used to test whether a given type can be used as the 'function' in a function call.- Overrides:
canBeCalledin classJSType- Returns:
trueif this type might be callable.
-
isStructuralType
public final boolean isStructuralType()
- Overrides:
isStructuralTypein classObjectType
-
isNoObjectType
public final boolean isNoObjectType()
- Overrides:
isNoObjectTypein classJSType
-
isNoResolvedType
public final boolean isNoResolvedType()
- Overrides:
isNoResolvedTypein classJSType
-
isUnknownType
public final boolean isUnknownType()
Description copied from class:ObjectTypeWe treat this as the unknown type if any of its implicit prototype properties is unknown.- Overrides:
isUnknownTypein classObjectType
-
isCheckedUnknownType
public final boolean isCheckedUnknownType()
- Overrides:
isCheckedUnknownTypein classJSType
-
isNullable
public final boolean isNullable()
Description copied from class:JSTypeTests whether this type is nullable.- Overrides:
isNullablein classJSType
-
isVoidable
public final boolean isVoidable()
Description copied from class:JSTypeTests whether this type is voidable.- Overrides:
isVoidablein classJSType
-
toMaybeEnumType
public final EnumType toMaybeEnumType()
Description copied from class:JSTypeDowncasts this to an EnumType, or returns null if this is not an EnumType.- Overrides:
toMaybeEnumTypein classJSType
-
isConstructor
public final boolean isConstructor()
Description copied from class:JSTypeWhether this type is aFunctionTypethat is a constructor or a named type that points to such a type.- Overrides:
isConstructorin classJSType
-
isNominalType
public boolean isNominalType()
Description copied from class:JSTypeWhether this type is a nominal type (a named instance object or a named enum).- Overrides:
isNominalTypein classJSType
-
isInstanceType
public final boolean isInstanceType()
Description copied from class:JSTypeWhether this type is an Instance object of some constructor. Does not necessarily mean this is anInstanceObjectType.- Overrides:
isInstanceTypein classJSType
-
isInterface
public final boolean isInterface()
Description copied from class:JSTypeWhether this type is aFunctionTypethat is an interface or a named type that points to such a type.- Overrides:
isInterfacein classJSType
-
isOrdinaryFunction
public final boolean isOrdinaryFunction()
Description copied from class:JSTypeWhether this type is aFunctionTypethat is an ordinary function (i.e. not a constructor, nominal interface, or record interface), or a named type that points to such a type.- Overrides:
isOrdinaryFunctionin classJSType
-
isStruct
public final boolean isStruct()
Description copied from class:JSTypeReturns true iffthiscan be astruct. UnionType overrides the method, assumethisis not a union here.
-
isDict
public final boolean isDict()
Description copied from class:JSTypeReturns true iffthiscan be adict. UnionType overrides the method, assumethisis not a union here.
-
isNativeObjectType
public final boolean isNativeObjectType()
Description copied from class:ObjectTypeWhether this is a built-in object.- Overrides:
isNativeObjectTypein classObjectType
-
toMaybeRecordType
public final RecordType toMaybeRecordType()
Description copied from class:JSTypeDowncasts this to a RecordType, or returns null if this is not a RecordType.- Overrides:
toMaybeRecordTypein classJSType
-
toMaybeUnionType
public final UnionType toMaybeUnionType()
Description copied from class:JSTypeDowncasts this to a UnionType, or returns null if this is not a UnionType. Named in honor of Haskell's Maybe type constructor.- Overrides:
toMaybeUnionTypein classJSType
-
toMaybeFunctionType
public final FunctionType toMaybeFunctionType()
Description copied from class:JSTypeDowncasts this to a FunctionType, or returns null if this is not a function.For the purposes of this function, we define a MaybeFunctionType as any type in the sub-lattice { x | LEAST_FUNCTION_TYPE <= x <= GREATEST_FUNCTION_TYPE } This definition excludes bottom types like NoType and NoObjectType.
This definition is somewhat arbitrary and axiomatic, but this is the definition that makes the most sense for the most callers.
- Overrides:
toMaybeFunctionTypein classJSType
-
toMaybeEnumElementType
public final EnumElementType toMaybeEnumElementType()
Description copied from class:JSTypeDowncasts this to an EnumElementType, or returns null if this is not an EnumElementType.- Overrides:
toMaybeEnumElementTypein classJSType
-
testForEquality
public final TernaryValue testForEquality(JSType that)
Description copied from class:JSTypeComparesthisandthat.- Overrides:
testForEqualityin classObjectType- Returns:
TernaryValue.TRUEif the comparison of values ofthistype andthatalways succeed (such asundefinedcompared tonull)TernaryValue.FALSEif the comparison of values ofthistype andthatalways fails (such asundefinedcompared tonumber)TernaryValue.UNKNOWNif the comparison can succeed or fail depending on the concrete values
-
getOwnerFunction
public final FunctionType getOwnerFunction()
- Overrides:
getOwnerFunctionin classObjectType
-
getCtorImplementedInterfaces
public java.lang.Iterable<ObjectType> getCtorImplementedInterfaces()
Description copied from class:ObjectTypeGets the interfaces implemented by the ctor associated with this type. Intended to be overridden by subclasses.- Overrides:
getCtorImplementedInterfacesin classObjectType
-
getCtorExtendedInterfaces
public java.lang.Iterable<ObjectType> getCtorExtendedInterfaces()
Description copied from class:ObjectTypeGets the interfaces extended by the interface associated with this type. Intended to be overridden by subclasses.- Overrides:
getCtorExtendedInterfacesin classObjectType
-
getImplicitPrototype
public final ObjectType getImplicitPrototype()
Description copied from class:ObjectTypeGets the implicit prototype (a.k.a. the[[Prototype]]property).- Specified by:
getImplicitPrototypein classObjectType
-
removeProperty
public final boolean removeProperty(java.lang.String name)
Description copied from class:ObjectTypeRemoves the declared or inferred property from this ObjectType.- Overrides:
removePropertyin classObjectType- Parameters:
name- the property's name- Returns:
- true if the property was removed successfully. False if the property did not exist, or could not be removed.
-
findPropertyTypeWithoutConsideringTemplateTypes
protected JSType findPropertyTypeWithoutConsideringTemplateTypes(java.lang.String propertyName)
Description copied from class:JSTypeLooks up a property on this type, but without properly replacing any templates in the result.Subclasses can override this if they need more complicated logic for property lookup than just autoboxing to an object.
This is only for use by
findPropertyType(JSType). Call that method instead if you need to lookup a property on a random JSType- Overrides:
findPropertyTypeWithoutConsideringTemplateTypesin classObjectType
-
getJSDocInfo
public final JSDocInfo getJSDocInfo()
Description copied from class:ObjectTypeGets the docInfo for this type.- Overrides:
getJSDocInfoin classObjectType
-
setJSDocInfo
public final void setJSDocInfo(JSDocInfo info)
Description copied from class:ObjectType- Overrides:
setJSDocInfoin classObjectType
-
setPropertyJSDocInfo
public final void setPropertyJSDocInfo(java.lang.String propertyName, JSDocInfo info)Description copied from class:ObjectTypeSets the docInfo for the specified property from theJSDocInfoon its definition.- Overrides:
setPropertyJSDocInfoin classObjectTypeinfo-JSDocInfofor the property definition. May benull.
-
getConstructor
public final FunctionType getConstructor()
Description copied from class:ObjectTypeGets this object's constructor.- Specified by:
getConstructorin classObjectType- Returns:
- this object's constructor or
nullif it is a native object (constructed natively v.s. by instantiation of a function)
-
getTemplateTypes
public com.google.common.collect.ImmutableList<JSType> getTemplateTypes()
Description copied from class:ObjectTypeGets the declared default element type.- Overrides:
getTemplateTypesin classObjectType- See Also:
TemplatizedType
-
getTemplateParamCount
public int getTemplateParamCount()
Description copied from class:JSTypeReturn the number of template parameters declared for this type.In general, this value corresponds to the number of `@template` declarations on the type definition. It does not include template parameters from superclasses or superinterfaces.
- Overrides:
getTemplateParamCountin classJSType
-
visitReferenceType
public final <T> T visitReferenceType(Visitor<T> visitor)
-
visit
public <T> T visit(Visitor<T> visitor)
Description copied from class:JSTypeVisit this type with the given visitor.- Overrides:
visitin classObjectType- Returns:
- the value returned by the visitor
- See Also:
Visitor
-
getTypeOfThis
public final JSType getTypeOfThis()
- Overrides:
getTypeOfThisin classObjectType
-
collapseUnion
public final JSType collapseUnion()
Description copied from class:JSTypeGets the least supertype of this that's not a union.- Overrides:
collapseUnionin classJSType
-
matchConstraint
public final void matchConstraint(JSType constraint)
Description copied from class:JSTypeModify this type so that it matches the specified type. This is useful for reverse type-inference, where we want to infer that an object literal matches its constraint (much like how the java compiler does reverse-inference to figure out generics).- Overrides:
matchConstraintin classJSType
-
toMaybeTemplatizedType
public TemplatizedType toMaybeTemplatizedType()
Description copied from class:JSTypeDowncasts this to a TemplatizedType, or returns null if this is not a templatized type.- Overrides:
toMaybeTemplatizedTypein classJSType
-
toMaybeTemplateType
public TemplateType toMaybeTemplateType()
Description copied from class:JSTypeDowncasts this to a TemplateType, or returns null if this is not a template type.- Overrides:
toMaybeTemplateTypein classJSType
-
hasAnyTemplateTypesInternal
public boolean hasAnyTemplateTypesInternal()
-
getTemplateTypeMap
public TemplateTypeMap getTemplateTypeMap()
Description copied from class:JSTypeReturns the template type map associated with this type.- Overrides:
getTemplateTypeMapin classJSType
-
-