Skip to content

Brackets Smoke Tests

njx edited this page Aug 30, 2012 · 46 revisions

Brackets has a pretty good automated test suite that you can run from Debug > Run Tests, but that doesn't always cover issues with the overall UI and integrated functionality, or visual/layout issues that are only obvious if you're actually looking at the product. This is a set of manual tests intended to make sure we haven't broken the basic overall workflows of the product. The intention is to keep it quick--if it takes more than 5 minutes on a given platform it's too long.

If you have trouble running through it or something is unclear, please post to the brackets-dev mailing list.

Setup

  1. Make sure your git status is clean and your brackets/src/extensions/user folder is empty (git status will not tell you about that folder).
  2. Quit and relaunch Chrome if it's open (so it's not in remote debugger mode).
  3. If you've run the smokes previously, revert any changes you might have made in brackets/test/smokes/citrus completed.
  4. Delete your cache folder (Mac: ~/Library/Application Support/com.adobe.Brackets.cefCache and ~/Library/Application Support/Brackets/cef_data, Win: %appdata%\Brackets\cefCache and %appdata%\Brackets\cef_data).

Smoke test steps

  1. Launch Brackets. Verify that the Brackets "Getting Started" folder is visible in the project panel and its index.html file is opened automatically.
  2. File > Open Folder and browse to the Brackets source folder.
  3. Expand some folders in the brackets project, enough that it has to scroll.
  4. Scroll around in the folder area. Verify that the shadows look right (appears at top when not scrolled all the way to the top) and there are no visual glitches.
  5. File > Open Folder and browse to the brackets/test/smokes/citrus completed folder (note that there's a space in the name; this is intentional) and click OK. In the Project panel, verify that it contains "css" and "images" folders and an "index.html" file.
  6. Click on index.html. Verify that the selection in the project panel draws properly.
  7. Double-click on index.html. Verify that it's added to the working set and the selection draws properly.
  8. Resize the window. Verify that the editor resizes properly and the title bar wraps appropriately.
  9. Look through the in-Brackets menus. Verify that they look okay and that they properly pop on top of other UI in the app.
  10. Set the cursor in the <body> tag immediately before the >.
  11. Enter a space. Verify that a list of attribute hints pops up and you can navigate the list with up/down arrow key.
  12. Hit Esc key to dismiss the code hints list, then delete the space so the cursor is after the "y" of "body".
  13. Hit Cmd/Ctrl-E. Verify that it shows a single body rule and that everything is laid out properly.
  14. Click the lightning bolt in the upper right. You should see the page load in Chrome. Mac only: after a few seconds you should get a dialog saying you need to relaunch Chrome.
  15. Mac only: Click "Relaunch". Chrome should relaunch and open the page.
  16. Back in Brackets, edit the background color for the tag in the inline editor (#D90 is a nice color). Verify that the color changes in Chrome as you type. Also verify that the CSS file is added to the working set with the dirty bit set.
  17. Hit Cmd/Ctrl-E. Verify that the inline editor closes.
  18. Put the cursor immediately after the <a in one of the <a> tags in the navbar.
  19. Hit Cmd/Ctrl-E. Verify that the inline editor opens and that you see a number of rules in the list on the right.
  20. Scroll up and down in the outer editor. Verify that the inline editor scrolls properly with the editor.
  21. Resize the window. Verify that the rule list moves properly and there are no visual glitches.
  22. Click on a rule in the rule list. Verify that the editor shows the correct rule.
  23. Quit the app. Verify that you get a "save changes" dialog for any CSS files you edited through the inline editor, and choose to discard the changes.
  24. Restart the app. Verify that the "citrus completed" project shows in the sidebar, and that the working set and current editor are showing the same files as when you quit. Also verify that the changes you had previously made were reverted (git status in the smokes folder should show clean).
Clone this wiki locally