Symbols

@Component decorator 44

@Injectable class decorators 73, 76–76

@types node 114

$timeout service 155–155

*ngFor 131

A

ActivatedRoute.snapshot.data 108

ActivatedRoute components, testing 101–102

afterEach function 19, 63

alertIsPresent 146

Angular platform

CLI

creating services with 76–77

installing 205–205

overview of 203–204

updating 205–206

verifying installation of 206–206

import statements 30–32

nontesting module statements 32–32

pages without, testing 142–145

routers in 94–97

services in 73–76

testing 1–9, 209–210

waiting for, automatically 144–144

applications, running 207–207

arrays, mapping contact lists to 133–135

async/await keywords 183–184

asynchronous code, changes to testing 86–88

asynchronous functions 180–181

asynchronous services, testing for failures with 88–89

<a> tag 120

attribute directives

overview of 45

testing 45–54

AuthenticationGuard 106

<base href> tag 94

B

BDD (behavior-driven development) 14

beforeEach functions, adding 34–35–36, 36

blocking proxy features 179–179

browser.executeScript method 151

browser.pause( ) method 186

browser.sleep( ) method 145

browser.takeScreenshot( ) method 170

browser.waitForAngular( ) function 171, 173

browser.waitForAngularEnabled() function 145–145

browser.wait function 124, 145, 150–151

browser event loops 155–155

browsers, obtaining elements from 151–151

browserstackKey 162

browserstackUser 162

BrowserStorage 75

BrowserStorageAsyncMock 88

BrowserStorageMock 80

by methods 125–127

C

CanActivateChild 97

canActivate property 97, 105, 106

CanDeactivate 97

catch method 89

Chrome DevTools, debugging Protractor with 180–187

chromedriver binary 116, 162

CI (continuous integration) 191–202

CircleCI platform 200–202

clear method 127

CLI (command-line interface) 2

click method 137, 138

code quality 7

color, adding as parameter 48–48

[color] parameter 48

command-line interface (CLI) 2

compareScreenshot( ) function 172, 173

comparing screenshots 172–175

components

directives vs. 44–45

of router parameters, testing 103–104

overview of 2

testing 25–29–41, 41

conditions, custom 150–151

configuration files, in Protractor 161–170

configureTestingModule method 51

ContactClass 17, 18

ContactDetail component 44

ContactEditComponent class 101

ContactFeedDialogComponent 157

contactId 94

Contact interface 134

ContactListComponent 72

ContactListPageObject 138

contact lists

mapping to arrays 133–135

waiting to load 146–147

ContactPreferences 83

contacts

creating 119–122

with invalid data 122–125

Contacts App Starter 6

ContactService, faking 34–34

contact variable 18, 19

control flow, in Protractor 180–187

createClickButton method 137

createComponent method 51

curr parameter 137

d

data, resolving before loading routes 107–108

debugging

Protractor, experimental features 176–179

Protractor with Chrome DevTools 180–187

defaultTrueElementIndex 52

default usage, for pipes 61–65

dependencies

importing 30–33

installing 206–206

dependency injections 74–75

describe function 14, 63

dialog, testing 147–148

directConnect flag 116, 162

directives

components vs. 44–45

overview of 2, 44–45

testing 43–58

testing attribute directives 45–54

testing structural directives 54–58

types of 45–45

disabling waitForAngular 143–144

dispatchEvent method 53

doBrowserThings( ) method 155

doClassesMatch method 52

done method 84

driver provider options, in Protractor 162–162

E

E2E (end-to-end) tests

on Jenkins 197–200

overview of 6–7

unit tests vs. 7–9

ElementFinder 120, 122

element methods 125–127

elements

interacting with in Protractor 118–125

interacting with list of 130–137

obtaining from browser 151–151

waiting to become stale 148–149

elementToBeClickable 146

elementToBeSelected 146

environment variables, in Protractor 168–170

expected conditions 154–154

ExpectedConditions object, waiting with 145–149

expectedOutlineStarList 53

expectedSolidStarList 52

expect method 14, 83

F

failing test 17

faking ContactService 34–34

FavoriteIcon 44

FEED_UPDATES array 153

file globbing 118

filterFn function 130

filter function 130

filtering web elements 130–132

findAllPosts( ) function 151

findElement method 125

fixture.detectChanges( ) method 51

fixture variable 50

flaky test 142

flushMicrotasks 88, 88

format parameter 65

format variable 66

FormBuilder 74

G

generating links 98–98

getAttribute method 127

getCssValue method 127

getElement function 56

getItem method 75, 79

get method 20

getProperty( ) method 80, 85

getPropertyAsync method 88

getStarElement method 52, 56

getTagName method 127

getText method 127

getWebElement method 127

globbing 118

H

happy path 82

headless environment 191

headless mode 164

highlight delay feature 178–179

-highlightDelay flag 178

HighlightRowDirective 43

HttpClient 71

HttpClientTestingModule 90, 91

HTTP services, with observables 89–92

I

I/O operation 180

IContactPreferences interface 80

id property 21

<i> element 50

importing dependencies 30–33

import statements

in Angular 30–32

overview of 57

IndexedDB 87

InjectionToken function 75

installing

Angular CLI

overview of 205–205

verifying installation of 206–206

dependencies 206–206

prerequisites 204–206

Protractor 117–118

sample projects 206–206

invisibilityOf 146

IS_CIRCLE variable 200

IS_JENKINS flag 197, 198

isDisplayed method 127

isElementPresent method 127

isPresent method 127

it method 14, 84, 182

J

jasmine-reporters node 166

Jenkins server 192–200

K

karma-chrome-launcher plugin 195

karma-junit-reporter plugin 194

L

lazy loading 97

lifecycle hooks 95, 166

links, generating 98–98

loadContact method 38–38

loading contact lists 146–147

loggingPrefs 164

long-running tasks 152–159

looksSame.createDiff( ) function 173

M

managed promise 181

map function 133

mapping contact lists, to arrays 133–135

matcher functions 14

mimicking user interactions 8

mock observables 105–105

mouseenter event 53

multiCapabilities 165

N

name property 20

NavConfigService 98

NavigationMenu component 98

NewContactPageObject 138

ngOnInit method 103

ng serve command 207

ng test command 53

NgZone.runOutsideAngular( ) function 156

node_module folder 118

nontesting module statements, in Angular 32–32

not.toBeNull( ) method 19

npm install command 206

O

observables

HTTP services with, testing 89–92

mock 105–105

onPrepare function 116, 166

OOP (object-oriented programming) 4

P

package.json 114–114

page objects, in Protractor 137–140

parameters

multiple, testing pipes with 67–69

single, testing pipes with 65–67

phone numbers

invalid, testing pipes for 64–65

valid, testing pipes for 62–64

pipes

overview of 2

testing 59–60–60–61, 69, 69

plugins, in Protractor 166–168

pollForever( ) function 156

postTest( ) function 171

pree2e script 114

PreferencesService

testing 77–82–82–82, 83, 83

writing 78–82

pre-loading data 105

prerequisites, installing 204–206

presenceOf 146

private access modifier 5

process.env.BROWSER_NAME 169

process.env.DIRECT_CONNECT 169

process.env.SELENIUM_ADDRESS 169

Promise.all method 135

Promise.resolve( ) method 155

promise chaining 174

promises

overview of 180–181

services with, testing 83–89

Protractor 111–140, 161–187

pure function 59

pyramid of doom 181

R

reduce function 135–137

resolve method 97

resolver guard 105

resolving data 105

routed components, testing 97–105

route guards 95, 96–97–105, 107

Router.navigate( ) method 101

router configuration 94

RouterLink directive 98

router parameters, testing 101–105

routers

in Angular 94–97

testing 93–108

testing navigation with RouterTestingModule 97–101

RouterTestingModule

configuring routes 99–99

creating test components 99–99

generating links 98–98

setting up routes 99–101

routes

advanced, testing 105–105–107, 108

configuring 99–99

resolving data before loading 107–108

setting up 99–101

routing 2

S

sanity check 5

sauceKey 162

sauceUser 162

saveContact method 37–37

saveProperty( ) method 80, 82

screenshots

comparing 172–175

in Protractor, testing 170–175

on test failure 171–172

taking 170–171

seleniumAddress 162

Selenium Server 112

seleniumServerJar 162

sendKeys method 121, 127, 138

separation of concerns principle 72

services 2

setItem method 75, 79

setProperty 85

shouldThrow assertion 82

ShowContactsDirective 55

side effect 59

snapshot 102

spy function 80

stale, elements 148–149

stalenessOf 146

starElement variable 51

structural directives

overview of 45

testing 54–58

styleUrls option 44

T

takeScreenshot( ) method 170, 171

templateUrl option 44

TestComponent class 50

testing

ActivatedRoute components 101–102

advanced routes 105–108

Angular applications 1–9, 209–210

attribute directives 45–54

components 25–29–41, 41

dialog 147–148

directives 43–58

for failures with asynchronous services 88–89

HTTP services with observables 89–92

loadContact method 38–38

pages without Angular 142–145

pipes 59–60–60–61, 69, 69

PreferencesService 77–82–82, 83

Protractor screenshots 170–175

routed components 97–105

router navigation with RouterTestingModule 97–101

router parameters 101–105

routers 93–108

saveContact method 37–37

services 71–83–89, 92

structural directives 54–58

UpdateContact method 38–41

testing documentation 209

TestModuleMetadata variable 51

tests

adding 37–41

creating 13–17–

E2E tests 6–7

for attribute directives, creating 48–48–51, 54

for Protractor, writing 114–114–117, 117

for structural directives, creating 55–56–57, 58

setting up 33–36

types of 5–9

unit tests 5–6

writing, using Jasmine 14–

test suites

for attribute directives, setting up 50–51

for structural directives, setting up 56–57

textToBePresentInElement 146

textToBePresentInElementValue 146

then( ) block 174

tick( ) method 84

timeouts 141–159

titleContains 146

titleIs 146

token-provider map 75

toString( ) method 5

toThrowError( ) method 82

transform method 60, 66

tsc command 115

ts-node npm package 166

TypeScript class

configuration files 115–115

overview of 3–5

U

unit tests 5–6

UpdateContact method, testing 38–41

urlContains 146

urlIs 146

UserAuthentication service 105

UserPreferencesResolver 107

V

vfb (virtual framebuffer) 192

viewProviders option 44

virtual framebuffer (vfb) 192

visibilityOf 146

W

waitForAngular function, disabling 143–144

WebDriver

control flow 181–183

logs 176–178

-webDriverLogDir option 176

webdriver-manager node module 114

WebElement class 151

web elements, filtering 130–132

whenStable method 84

window.setTimeout( ) method 155

writeScreenshot( ) function 172

X

XMLHttpRequest( ) method 155

Xvfb plugin 193

Z

zone 84, 156