import { beforeEach, ddescribe, describe, expect, iit, inject, it, xdescribe, xit } from '@angular/core/testing/testing_internal'; import {IS_DART, RegExpWrapper, StringWrapper} from '../facade/src/lang'; import {getSymbolsFromLibrary} from './symbol_inspector/symbol_inspector'; import {ListWrapper} from '../facade/src/collection'; // ================================================================================================= // ================================================================================================= // =========== S T O P - S T O P - S T O P - S T O P - S T O P - S T O P =========== // ================================================================================================= // ================================================================================================= // // DO NOT EDIT THIS LIST OF PUBLIC APIS UNLESS YOU GET IT CLEARED BY: mhevery, vsavkin, or tbosch! // // ================================================================================================= // ================================================================================================= // Note that this test only tests for *values* exported (e.g. classes, functions, variables), but // not for *types* exported (interfaces, typedefs). // See tools/public_api_guard/public_api_spec.ts for a type based test. // ================================================================================================= var COMMON: string[] = [ 'APP_BASE_HREF', 'HashLocationStrategy', 'Location', 'LocationStrategy', 'PathLocationStrategy', 'PlatformLocation', 'AbstractControl', 'AbstractControlDirective', 'AsyncPipe', 'COMMON_DIRECTIVES', 'COMMON_PIPES', 'CORE_DIRECTIVES', 'CheckboxControlValueAccessor', 'Control', 'ControlArray', 'ControlContainer', 'ControlGroup', 'ControlValueAccessor:dart', 'CurrencyPipe', 'DatePipe', 'DecimalPipe', 'DefaultValueAccessor', 'FORM_BINDINGS', 'FORM_DIRECTIVES', 'FORM_PROVIDERS', 'Form:dart', 'FormBuilder', 'I18nPluralPipe', 'I18nSelectPipe', 'JsonPipe', 'LowerCasePipe', 'MaxLengthValidator', 'MinLengthValidator', 'NG_ASYNC_VALIDATORS', 'NG_VALIDATORS', 'NG_VALUE_ACCESSOR', 'NgClass', 'NgControl', 'NgControlGroup', 'NgControlName', 'NgControlStatus', 'NgFor', 'NgForm', 'NgFormControl', 'NgFormModel', 'NgIf', 'NgTemplateOutlet', 'NgModel', 'NgSelectOption', 'NgStyle', 'NgSwitch', 'NgSwitchWhen', 'NgSwitchDefault', 'NumberPipe', 'ObservableListDiff:dart', 'ObservableListDiffFactory:dart', 'PatternValidator', 'PercentPipe', 'ReplacePipe', 'RequiredValidator', 'SelectControlValueAccessor', 'SlicePipe', 'UpperCasePipe', 'Validator:dart', 'Validators', 'RadioButtonState', 'NgLocalization', 'NgPlural', 'NgPluralCase' ]; var COMMON_TESTING: string[] = ['MockLocationStrategy', 'SpyLocation']; var COMPILER: string[] = [ 'ElementSchemaRegistry', '__compiler_private__', "TemplateAst:dart", "TemplateAstVisitor:dart", "DEFAULT_PACKAGE_URL_PROVIDER", "UrlResolver", "AttrAst", "BoundDirectivePropertyAst", "BoundElementPropertyAst", "BoundEventAst", "BoundTextAst", "COMPILER_PROVIDERS", "CompileDirectiveMetadata", "CompileTemplateMetadata", "CompileTypeMetadata", "DirectiveAst", "ElementAst", "EmbeddedTemplateAst", "NgContentAst", "PropertyBindingType", "SourceModule", "TEMPLATE_TRANSFORMS", "TextAst", "VariableAst", "ReferenceAst", "XHR", "templateVisitAll", "CompileDiDependencyMetadata", "CompileFactoryMetadata", "CompileIdentifierMetadata", "CompileMetadataWithIdentifier", "CompileMetadataWithType", "CompilePipeMetadata", "CompileProviderMetadata", "CompileQueryMetadata", "CompileTokenMetadata", "CompilerConfig", "RenderTypes", "DirectiveResolver", "NormalizedComponentWithViewDirectives", "OfflineCompiler", "RuntimeCompiler", "PipeResolver", "ProviderAst", "ProviderAstType", "ViewResolver", "createOfflineCompileUrlResolver" ]; var COMPILER_TESTING: string[] = [ 'ComponentFixture', 'ComponentFixtureAutoDetect', 'ComponentFixtureNoNgZone', 'MockDirectiveResolver', 'MockSchemaRegistry', 'MockViewResolver', 'MockXHR', 'TestComponentBuilder', 'TestComponentRenderer' ]; // API Classification audited var CORE: string[] = [ '__core_private__', 'BaseException', 'DefaultIterableDiffer', 'getDebugNode', 'wtfCreateScope', 'wtfEndTimeRange', 'wtfLeave', 'wtfStartTimeRange', 'APP_INITIALIZER', 'APP_ID', 'AbstractProviderError', 'AUTO_STYLE', 'AnimationAnimateMetadata', 'AnimationEntryMetadata', 'AnimationGroupMetadata', 'AnimationMetadata', 'AnimationSequenceMetadata', 'AnimationStateDeclarationMetadata', 'AnimationStateMetadata', 'AnimationStateTransitionMetadata', 'AnimationStyleMetadata', 'AnimationWithStepsMetadata', 'AnimationKeyframesSequenceMetadata', 'AnimationPlayer', 'animate', 'group', 'sequence', 'state', 'style', 'keyframes', 'trigger', 'transition', 'ApplicationRef', 'APPLICATION_COMMON_PROVIDERS', 'Attribute', 'AttributeMetadata', 'Binding', 'Provider', 'ProviderBuilder', 'PLATFORM_DIRECTIVES', "CollectionChangeRecord", 'ChangeDetectionStrategy', 'ChangeDetectorRef', 'Class', 'ComponentResolver', 'SystemJsComponentResolver', 'Component', 'ComponentMetadata', 'ComponentRef', 'ContentChild', 'ContentChildMetadata', 'ContentChildren', 'ContentChildrenMetadata', 'CyclicDependencyError', 'PLATFORM_PIPES', 'DebugNode', 'DebugElement', 'Directive', 'DirectiveMetadata', 'DynamicComponentLoader', 'ElementRef', 'Output', 'EmbeddedViewRef', 'EventEmitter', 'ExceptionHandler', 'OutputMetadata', 'enableProdMode', 'ExpressionChangedAfterItHasBeenCheckedException', 'Host', 'HostBinding', 'HostBindingMetadata', 'HostListener', 'HostListenerMetadata', 'HostMetadata', 'ComponentFactory', 'Inject', 'InjectMetadata', 'Injectable', 'InjectableMetadata', 'Injector', 'ReflectiveInjector', 'InstantiationError', 'InvalidProviderError', 'IterableDiffers', 'ReflectiveKey', 'KeyValueChangeRecord', 'KeyValueDiffers', 'NgZone', 'NgZoneError', 'NoAnnotationError', 'NoProviderError', 'OpaqueToken', 'Optional', 'OptionalMetadata', 'OutOfBoundsError', 'Pipe', 'PipeMetadata', 'PlatformRef', 'Input', 'InputMetadata', 'Query', 'QueryList', 'QueryMetadata', 'Renderer', 'RootRenderer', 'RenderComponentType', 'ResolvedReflectiveFactory', 'Self', 'SelfMetadata', 'SkipSelf', 'SkipSelfMetadata', 'SimpleChange', 'TemplateRef', 'Testability', 'TestabilityRegistry', 'setTestabilityGetter', 'Type', 'PACKAGE_ROOT_URL', 'ViewChild', 'ViewChildMetadata', 'ViewChildren', 'ViewChildrenMetadata', 'ViewContainerRef', 'ViewEncapsulation', 'ViewMetadata', 'ViewQuery', 'ViewQueryMetadata', 'WrappedException', 'WrappedValue', 'asNativeElements', 'bind', 'provide', 'createNgZone', 'forwardRef', 'coreBootstrap', 'coreLoadAndBootstrap', 'createPlatform', 'disposePlatform', 'getPlatform', 'assertPlatform', 'resolveForwardRef', 'PLATFORM_COMMON_PROVIDERS', 'PLATFORM_INITIALIZER', 'AfterContentChecked', 'AfterContentInit', 'AfterViewChecked', 'AfterViewInit', 'DoCheck', 'OnChanges', 'OnDestroy', 'OnInit', 'ViewRef', ]; var CORE_TESTING: string[] = [ 'InjectSetupWrapper', 'Log', 'MockApplicationRef', 'MockNgZone', 'TestInjector', 'afterEach', 'async', 'beforeEach', 'beforeEachProviders', 'clearPendingTimers', 'containsRegexp', 'ddescribe', 'describe', 'expect', 'fakeAsync', 'fdescribe', 'fit', 'flushMicrotasks', 'getTestInjector', 'getTypeOf', 'iit', 'inject', 'injectAsync', 'instantiateType', 'it', 'resetBaseTestProviders', 'setBaseTestProviders', 'tick', 'discardPeriodicTasks', 'withProviders', 'xdescribe', 'xit' ]; var PLATFORM_BROWSER: string[] = [ '__platform_browser_private__', 'AngularEntrypoint:dart', 'bootstrap', 'bootstrapApp', 'bootstrapRender', 'BROWSER_APP_PROVIDERS', 'BROWSER_APP_COMPILER_PROVIDERS', 'BROWSER_PLATFORM_PROVIDERS', 'BROWSER_PROVIDERS', 'BROWSER_SANITIZATION_PROVIDERS', 'browserPlatform', 'BrowserPlatformLocation', 'By', 'CACHED_TEMPLATE_PROVIDER', 'ClientMessageBroker', 'ClientMessageBrokerFactory', 'disableDebugTools', 'DOCUMENT', 'DomEventsPlugin', 'DomSanitizationService', 'ELEMENT_PROBE_PROVIDERS', 'enableDebugTools', 'EVENT_MANAGER_PLUGINS', 'EventManager', 'FnArg', 'HAMMER_GESTURE_CONFIG', 'HammerGestureConfig', 'initializeGenericWorkerRenderer', 'KeyEventsPlugin', 'MessageBus', 'PRIMITIVE', 'ReceivedMessage', 'SecurityContext', 'ServiceMessageBroker', 'ServiceMessageBrokerFactory', 'Title', 'UiArguments', 'UrlChangeEvent:dart', 'UrlChangeListener:dart', 'WebWorkerInstance', 'WORKER_APP_APPLICATION_PROVIDERS', 'WORKER_APP_LOCATION_PROVIDERS', 'WORKER_APP_PLATFORM_PROVIDERS', 'WORKER_RENDER_APPLICATION_PROVIDERS', 'WORKER_RENDER_LOCATION_PROVIDERS', 'WORKER_RENDER_PLATFORM_PROVIDERS', 'WORKER_RENDER_STARTABLE_MESSAGING_SERVICE', 'WORKER_SCRIPT', 'workerAppPlatform', 'workerRenderPlatform' ]; var PLATFORM_BROWSER_TESTING: string[] = [ 'ADDITIONAL_TEST_BROWSER_PROVIDERS', // This should be made private 'ADDITIONAL_TEST_BROWSER_STATIC_PROVIDERS', // This should be made private 'BrowserDetection', 'browserDetection', 'dispatchEvent', 'DOMTestComponentRenderer', 'el', 'expect', 'normalizeCSS', 'stringifyElement', 'TEST_BROWSER_APPLICATION_PROVIDERS', 'TEST_BROWSER_PLATFORM_PROVIDERS', 'TEST_BROWSER_STATIC_APPLICATION_PROVIDERS', 'TEST_BROWSER_STATIC_PLATFORM_PROVIDERS' ]; var PLATFORM_SERVER: string[] = ['Parse5DomAdapter']; var PLATFORM_SERVER_TESTING: string[] = ['TEST_SERVER_APPLICATION_PROVIDERS', 'TEST_SERVER_PLATFORM_PROVIDERS']; var UPGRADE: string[] = [ 'UpgradeAdapter', 'UpgradeAdapterRef', ]; var HTTP: string[] = [ 'BaseRequestOptions', 'BaseResponseOptions', 'BrowserXhr', 'Connection', 'ConnectionBackend', 'HTTP_BINDINGS', 'HTTP_PROVIDERS', 'Headers', 'Http', 'JSONPBackend', 'JSONPConnection', 'JSONP_PROVIDERS', 'JSON_BINDINGS', 'Jsonp', 'ReadyState', 'Request', 'RequestMethod', 'RequestOptions', 'Response', 'ResponseOptions', 'ResponseType', 'URLSearchParams', 'XHRBackend', 'XHRConnection' ]; var HTTP_TESTING: string[] = ['MockBackend', 'MockConnection']; var ROUTER_DEPRECATED: string[] = [ 'AsyncRoute', 'AuxRoute', 'CanActivate', 'ComponentInstruction', 'Instruction', 'OpaqueToken', 'ROUTER_BINDINGS', 'ROUTER_DIRECTIVES', 'ROUTER_PRIMARY_COMPONENT', 'ROUTER_PROVIDERS', 'ROUTER_PROVIDERS_COMMON', 'Redirect', 'Route', 'RouteConfig', 'RouteData', 'RouteParams', 'RouteRegistry', 'Router', 'RouterLink', 'RouterOutlet' ]; var ROUTER_DEPRECATED_TESTING: string[] = []; var ROUTER: string[] = [ 'ROUTER_DIRECTIVES', 'ROUTER_PROVIDERS', 'Route', 'Router', 'DefaultRouterUrlSerializer', 'RouteSegment', 'RouteTree', 'RouterOutletMap', 'RouterUrlSerializer', 'Routes', 'Tree', 'UrlSegment', 'UrlTree' ]; var ROUTER_TESTING: string[] = ['ROUTER_FAKE_PROVIDERS']; var API = { 'common': COMMON, 'common/testing': COMMON_TESTING, 'compiler': COMPILER, 'compiler/testing': COMPILER_TESTING, 'core': CORE, 'core/testing': CORE_TESTING, 'http': HTTP, 'http/testing': HTTP_TESTING, 'router-deprecated': ROUTER_DEPRECATED, 'router-deprecated/testing': ROUTER_DEPRECATED_TESTING, 'router': ROUTER, 'router/testing': ROUTER_TESTING, 'upgrade': UPGRADE, 'platform-browser': PLATFORM_BROWSER, 'platform-browser/testing': PLATFORM_BROWSER_TESTING, 'platform-server': PLATFORM_SERVER, 'platform-server/testing': PLATFORM_SERVER_TESTING }; export function main() { /** var x = getSymbolsFromLibrary('ng'); x.sort(); var parts = []; x.forEach((i) => parts.push(`'${i'`)); print(`[ ${parts.join(', ')} ]`); */ describe('public API', () => { var barrelList = [ 'common', 'common/testing', 'compiler', 'compiler/testing', 'core', 'core/testing', 'http', 'http/testing', 'router', 'router/testing', 'upgrade', 'platform-browser', 'platform-browser/testing', 'platform-server', 'platform-server/testing' ]; if (IS_DART) { barrelList = barrelList.filter(b => b !== 'upgrade'); } barrelList.forEach(mod => { // Dom Events are merged into DomAdapter in Dart if (IS_DART && mod === 'ngPlatformDomEvent') return; it(`should fail if public API for ${mod} has changed`, () => { var symbols = getSymbolsFromLibrary(mod); expect(diff(symbols, API[mod])).toEqual([]); }) }); }); } function diff(actual: string[], expected: string[]): string[] { ListWrapper.sort(actual, compareIgnoreLang); ListWrapper.sort(expected, compareIgnoreLang); let mode = IS_DART ? "dart" : "js"; let missing = actual.filter(i => expected.indexOf(i) < 0 && expected.indexOf(`${i}:${mode}`) < 0) .map(s => `+${s}`); let extra = expected.filter(i => shouldIgnore(i) ? false : (actual.indexOf(stripLang(i)) < 0)) .map(s => `-${s}`); return ListWrapper.concat(missing, extra); } function shouldIgnore(expected: string): boolean { let isDart = RegExpWrapper.create('\\:dart$'); let isJs = RegExpWrapper.create('\\:js$'); return IS_DART ? RegExpWrapper.test(isJs, expected) : RegExpWrapper.test(isDart, expected); } function compareIgnoreLang(a: string, b: string): number { return StringWrapper.compare(stripLang(a), stripLang(b)); } function stripLang(text: string): string { let index = text.indexOf(':'); return (index >= 0) ? text.substring(0, index) : text; }