Nanodegree Feedreader

This is a web-based application that reads RSS feeds. Jasmine and test suites are included for functionality test purpose!

How to access?

Click this link

How to run on a local computer?

You can download the entire project from here -- Or -- You can use git to clone this project to your local computer: git clone git@github.com:geekmichael/frontend-nanodegree-feedreader.git then open this index.html file with web browser

What are included test suits?

RSS Feeds

This suite is all about the RSS feeds definitions, the allFeeds variable in the application.

• tests to make sure that the allFeeds variable has been defined and that it is not empty.
• loops through each feed in the allFeeds object and ensures it has a URL defined and that the URL is not empty.
• loops through each feed in the allFeeds object and ensures it has a name defined and that the name is not empty.

The menu

This suite is all about the MENU setting changes while clicked.

• ensures the menu element is hidden by default.
• ensures the menu changes visibility when the menu icon is clicked.

Initial Entries

This suite is all about the initial entries when the application is loaded at the first time.

• ensures when the loadFeed function is called and completes its work, there is at least a single .entry element within the .feed container.

New Feed Selection

This suite ensures when a new feed is loaded by the loadFeed function that the content actually changes.

Why this Project?

To accomplish the Nanodegree course, getting to understand how to perform JavaScript testing is extremely important. Testing is not only critical for the development process, developers should also practice a standard of development known as "test-driven development". This is when developers write tests first, before they ever start developing their application. All the tests initially fail and then they start writing application code to make these tests pass.

Whether we work in an organization that uses test-driven development or in an organization that uses tests to make sure future feature development doesn't break existing features, it's an important skill to have!

What did I learn in this project?

I learned how to use Jasmine to write a number of tests against a pre-existing application. These test suits check the underlying business logic of the application as well as the event handling and DOM manipulation.

Original project instruction provided by udacity

Review the Feed Reader Testing Project Rubric

1. Take the JavaScript Testing course
2. Download the required project assets.
3. Review the functionality of the application within your browser.
4. Explore the application's HTML (./index.html), CSS (./css/style.css) and JavaScript (./js/app.js) to gain an understanding of how it works.
5. Explore the Jasmine spec file in ./jasmine/spec/feedreader.js and review the Jasmine documentation.
6. Edit the allFeeds variable in ./js/app.js to make the provided test fail and see how Jasmine visualizes this failure in your application.
7. Return the allFeeds variable to a passing state.
8. Write a test that loops through each feed in the allFeeds object and ensures it has a URL defined and that the URL is not empty.
9. Write a test that loops through each feed in the allFeeds object and ensures it has a name defined and that the name is not empty.
10. Write a new test suite named "The menu".
11. Write a test that ensures the menu element is hidden by default. You'll have to analyze the HTML and the CSS to determine how we're performing the hiding/showing of the menu element.
12. Write a test that ensures the menu changes visibility when the menu icon is clicked. This test should have two expectations: does the menu display when clicked and does it hide when clicked again.
13. Write a test suite named "Initial Entries".
14. Write a test that ensures when the loadFeed function is called and completes its work, there is at least a single .entry element within the .feed container.
15. Write a test suite named "New Feed Selection".
16. Write a test that ensures when a new feed is loaded by the loadFeed function that the content actually changes.
17. No test should be dependent on the results of another.
18. Callbacks should be used to ensure that feeds are loaded before they are tested.
19. Implement error handling for undefined variables and out-of-bound array access.
20. When complete - all of your tests should pass.
21. Write a README file detailing all steps required to successfully run the application. If you have added additional tests (for Udacious Test Coverage), provide documentation for what these future features are and what the tests are checking for.