Ember.js - A JavaScript framework for creating ambitious web applications
JavaScript Other
Latest commit c63793d Jul 24, 2016 @rwjblue rwjblue committed on GitHub Merge pull request #13875 from pranjalk/master
[DOC Canary] Added comments for ember-testing helper scripts
Failed to load latest commit information.
bin Test against jQuery 2.2.4 Jun 16, 2016
blueprints Remove JSHint directives from Mocha test blueprints Jun 18, 2016
config Update jQuery version for package manager Jun 16, 2016
generators [DOC] Update copyright year Feb 18, 2016
lib Make it possible to build without HTMLBars. Jul 23, 2016
node-tests Change ember.js test blueprints May 31, 2016
packages Merge pull request #13875 from pranjalk/master Jul 24, 2016
scripts Improved File Size script Apr 21, 2012
server Allow `hidepassed` to be toggled. Apr 6, 2015
tests Update node tests to properly simulate precompilation. Jul 19, 2016
.bowerrc Broccolify. May 13, 2014
.editorconfig Add EditorConfig file Jul 21, 2014
.gitattributes Adds .gitattributes file to remove any concerns about collaborators h… Apr 1, 2016
.gitignore Remove '*.swp' from .gitignore May 13, 2015
.gitmodules Update gitsubmodules urls to public repos. Jan 7, 2013
.jscsrc Enforce const usage in module scope only. Nov 4, 2015
.jshintrc Cleanup Ember.Test, Ember.testing, Ember.onerror May 4, 2016
.npmignore Add "ember-cli-blueprint-test-helpers" dev dependency Mar 6, 2016
.travis.yml Update to new Travis Trusty Beta Jun 12, 2016
.watchmanconfig many build tool upgrades: Jun 7, 2015
CHANGELOG.md v2.6.1 CHANGELOG [ci skip] Jul 11, 2016
CODE_OF_CONDUCT.md Add link to community guidelines as CODE_OF_CONDUCT.md. Jun 20, 2015
CONTRIBUTING.md Added commands to simplify the build processes Mar 13, 2016
FEATURES.md [FEATURE ember-string-ishtmlsafe] Changed `Ember.String.isHtmlSafe` t… Jul 15, 2016
LICENSE [DOC] Update copyright year Jan 16, 2016
README.md Fix travis-ci badge Jun 17, 2016
STYLEGUIDE.md Don't cache length property in for loops Apr 20, 2016
VERSION Branch 2.7.0-canary Apr 11, 2016
bower.json Bump router.js to support async getHandler method Jul 14, 2016
ember-cli-build.js Don't run glimmer engine tests in ember. (#13531) May 19, 2016
ember-source.gemspec [BUGFIX beta] Remove handlebars from dependencies Dec 29, 2014
features.json [FEATURE ember-testing-check-waiters] Enable by default. Jul 22, 2016
index.js package.json: Add "ember-addon" keyword Feb 23, 2016
package.json Don’t make `Iterable`s volatile Jul 24, 2016
testem.dist.json Update sauce labs browser listing. May 2, 2016
testem.json create multiple tested files for each variation: Jul 7, 2015
yuidoc.json Add container to yuidoc.json Jul 14, 2016

README.md

Ember.js Build Status Code Climate Slack

Sauce Test Status

Ember.js is a Javascript framework that greatly reduces the time, effort and resources needed to build any web application. It is focused on making you, the developer, as productive as possible by doing all the common, repetitive, yet essential, tasks involved in most web development projects.

Ember.js also provides access to the most advanced features of Javascript, HTML and the Browser giving you everything you need to create your next killer web app.

Building Ember.js

  1. Ensure that Node.js and bower are installed.
  2. Run git clone https://github.com/emberjs/ember.js.git && cd ember.js.
  3. Run git config core.symlinks true to ensure that symlinks are enabled.
  4. Run git reset --hard HEAD to reset to HEAD with symlinks.
  5. Run npm install to ensure the required dependencies are installed.
  6. Run bower install to ensure required web dependencies are installed.
  7. Run npm run build to build Ember.js. The builds will be placed in the dist/ directory.

npm install troubleshooting

If you encounter a problem with downloading dependencies like:

npm ERR! registry error parsing json

consider upgrading npm with:

npm install -g npm@latest

You can find more information in Upgrading on *nix (OSX, Linux, etc.) npm wiki page.

Contribution

See CONTRIBUTING.md

How to Run Unit Tests

Pull requests should pass the Ember.js unit tests. Do the following to run these tests.

  1. Follow the setup steps listed above under Building Ember.js.

  2. To start the development server, run npm start.

  3. To run all tests, visit http://localhost:4200/.

  4. To test a specific package, visit http://localhost:4200/tests/index.html?package=PACKAGE_NAME. Replace PACKAGE_NAME with the name of the package you want to test. For example:

To test multiple packages, you can separate them with commas.

You can also pass jquery=VERSION in the test URL to test different versions of jQuery.

From the CLI

  1. Install phantomjs from http://phantomjs.org.

  2. Run npm test to run a basic test suite or run TEST_SUITE=all npm test to run a more comprehensive suite.

From ember-cli

  1. ember test --server
  2. connect the browsers you want
  3. if phantom didn't connect automatically, you can run ./bin/connect-phantom-to <optional-port>

To run a specific browser, you can use the --launch flag

  • ember test --server --launch SL_Firefox_Current
  • ember test --launch SL_Firefox_Current