Skip to content
This repository was archived by the owner on Jan 16, 2024. It is now read-only.

Commit c4c1c98

Browse files
SylChamberSylChamber
committed
Initial commit, empty app with dependencies and configuration
- angular and angular-mocks - jasmine - jsdom - eslint
0 parents  commit c4c1c98

File tree

8 files changed

+1961
-0
lines changed

8 files changed

+1961
-0
lines changed

‎.eslintrc.json

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
{
2+
"env": {
3+
"browser": true,
4+
"commonjs": true,
5+
"es6": true,
6+
"jasmine": true,
7+
"node": true
8+
},
9+
"extends": "eslint:recommended",
10+
"globals": {
11+
"angular": false,
12+
"module": false,
13+
"inject": false
14+
},
15+
"parserOptions": {
16+
"ecmaVersion": 2015
17+
},
18+
"plugins": [
19+
"angular",
20+
"jasmine"
21+
],
22+
"rules": {
23+
"indent": [
24+
"error",
25+
4
26+
],
27+
"linebreak-style": [
28+
"error",
29+
"windows"
30+
],
31+
"quotes": [
32+
"error",
33+
"single"
34+
],
35+
"semi": [
36+
"error",
37+
"always"
38+
]
39+
}
40+
}

‎.gitignore

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
# Logs
2+
logs
3+
*.log
4+
npm-debug.log*
5+
yarn-debug.log*
6+
yarn-error.log*
7+
8+
# Runtime data
9+
pids
10+
*.pid
11+
*.seed
12+
*.pid.lock
13+
14+
# Directory for instrumented libs generated by jscoverage/JSCover
15+
lib-cov
16+
17+
# Coverage directory used by tools like istanbul
18+
coverage
19+
20+
# nyc test coverage
21+
.nyc_output
22+
23+
# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
24+
.grunt
25+
26+
# Bower dependency directory (https://bower.io/)
27+
bower_components
28+
29+
# node-waf configuration
30+
.lock-wscript
31+
32+
# Compiled binary addons (https://nodejs.org/api/addons.html)
33+
build/Release
34+
35+
# Dependency directories
36+
node_modules/
37+
jspm_packages/
38+
39+
# TypeScript v1 declaration files
40+
typings/
41+
42+
# Optional npm cache directory
43+
.npm
44+
45+
# Optional eslint cache
46+
.eslintcache
47+
48+
# Optional REPL history
49+
.node_repl_history
50+
51+
# Output of 'npm pack'
52+
*.tgz
53+
54+
# Yarn Integrity file
55+
.yarn-integrity
56+
57+
# dotenv environment variables file
58+
.env
59+
60+
# parcel-bundler cache (https://parceljs.org/)
61+
.cache
62+
63+
# next.js build output
64+
.next
65+
66+
# nuxt.js build output
67+
.nuxt
68+
69+
# vuepress build output
70+
.vuepress/dist
71+
72+
# Serverless directories
73+
.serverless

‎.vscode/settings.json

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
{
2+
"eslint.enable": true,
3+
"eslint.provideLintTask": true,
4+
"files.defaultLanguage": "javascript",
5+
"jasmineExplorer.config": "./jasmine.json",
6+
"npm.enableScriptExplorer": true
7+
}

‎LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2018 Sylvain Chamberland
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# ng1-tests - Unit Testing AngularJS Apps using Jasmine in Node.js
2+
3+
## Introduction
4+
5+
This project documents how to write unit tests on legacy AngularJS apps using Node.js and the Jasmine command line.
6+
7+
AngularJS support may cease in a couple of years, but there are still AngularJS apps being maintained, and in some case, developed because of mandatory choices in some organizations.
8+
9+
Usually, developers use Karma or the browser to unit test AngularJS apps. I personally find the developer experience *underwhelming* in both cases:
10+
11+
* with Karma:
12+
* debugging from Visual Studio Code is not optimal, because if tests are run in a browser, debugging setup is not easy, and a debugging session takes time to start because the browser must be launched
13+
* in my attempts, debugging sometimes failed
14+
* I could not find how to debug with JSDOM as a browser instead
15+
* the output is not really developer-friendly, when compared to a modern runner like [Jest](https://jestjs.io/)
16+
* with a browser:
17+
* when using the Jasmine spec runner HTML file, debugging must be done in the browser instead of in the IDE
18+
* constantly switching from the IDE to the browser, and back, is far from a great developer experience and is IMHO an obstacle to adopting TDD
19+
20+
Coming from a .NET and Node.js background, I greatly prefer debugging from my IDE of choice. And with JavaScript, that is Visual Studio Code.
21+
22+
The React and Vue.js communities run tests under Node.js with a simulated browser, [jsdom](https://github.com/jsdom/jsdom). It **is** possible to use the same technique with AngularJS, but testing AngularJS code with jsdom requires a specific and obscure setup.
23+
24+
I greatly prefer the Jest test runner and the [Jest extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=Orta.vscode-jest): the developer experience is **magical**. However, Jasmine may be the mandatory test framework in your organization (it is, in mine). Furthermore, Jasmine is the standard for testing in the AngularJS community.
25+
26+
Consequently, this project will use the [Jasmine command line for Node.js](https://jasmine.github.io/setup/nodejs.html). The setup is harder, because Jest has integrated DOM simulation with `jsdom`, and Jasmine for Node.js, of course, does not (because it's meant for Node.js apps).
27+
28+
But there is a really great Visual Studio Code extension for running Jasmine tests, [Jasmine Test Explorer](https://marketplace.visualstudio.com/items?itemName=hbenl.vscode-jasmine-test-adapter), that is coming around very nicely and features a test explorer UI (which the Jest extension lacks) which reminds of the Visual Studio 2017 test explorer with live testing.

‎jasmine.json

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
{
2+
"spec_dir": "src",
3+
"helpers": [
4+
"helpers/**/*.js"
5+
],
6+
"spec_files": [
7+
"**/*.module.js",
8+
"**/*.component.js",
9+
"**/*[sS]pec.js"
10+
],
11+
"stopSpecOnExpectationFailure": false,
12+
"random": true
13+
}

0 commit comments

Comments
 (0)