← JavaScript Discovery AcademyHelp

How to use JavaScript Discovery Academy

Start small. Read the output. Change one thing. Keep evidence of why it works.

About the academy

JavaScript Discovery Academy teaches programming through actual executions, code explanations and complete applications. The 100-lesson path has 20 five-lesson modules. Existing DiscoveryVIP advanced guides stay available separately. You do not need an account, AI subscription or API key.

Getting started

Select Write Your First JavaScript Code. In Source code, find console.log("Hello, JavaScript!"); and select Run Code. Console displays the message. Change only the quoted text and run again. Try the name field to generate a variable-based greeting. Use Next lesson when you can explain what changed.

Understanding JavaScript

JavaScript describes behavior. HTML describes document structure; CSS styles it. A console message is one observable operation, not a webpage control. Pure code executes in a worker without document. DOM examples execute in a separate page where document is available.

Following the learning path

Open Learn. Expand one module, search titles or use Jump to lesson. The current lesson is highlighted. Read its objectives and concept, write a prediction, then load and run each example. More advanced examples list their prerequisite. All lessons remain accessible; recommendations never lock them.

Running code and reading the console

Run Code executes the exact current source. Messages are prefixed with LOG, WARN or ERROR for worker examples. A thrown error is shown separately. A program can finish without logging anything. DOM previews show captured messages and runtime errors. Expected output is a contract for the prepared example, not a fabricated run.

Using the source editor

Source code is editable JavaScript. The More programming controls disclosure includes a highlighted source view and code font size. Ctrl+Enter or Command+Enter runs code. Tab moves focus normally. Ctrl+] or Command+] inserts two spaces. A missing quote is a syntax error; correcting unrelated lines usually makes diagnosis harder.

Using visual learning objects

Open Playground, choose an Interactive learning object, then Open selected object. There are 40 independent objects. Pure-code objects accept a JSON literal parameter; Apply value to prepared source generates visible code. Run it, then replay captured states. DOM objects use a real preview and expose the tree, events and control state. Container and stack diagrams are teaching models, not literal engine memory.

Understanding Step Through

Run Code records supported top-level statements and explicit trace calls. Step Through starts replay; Previous Step and Next Step choose recorded snapshots. Play advances every 800 milliseconds and Pause stops replay. Replaying does not rerun code. Arbitrary nested engine state is not inspected; trace calls expose only the values supplied by the authored example.

Completing challenges

Open Challenges, select 200 coding activities, choose a module and open an activity. Read the intended output. Run the starter to observe its behavior, form a hypothesis, repair one operation and select Check My Work. Checks compare results rather than exact source strings, so alternative implementations can pass. Prepared cases are not proof for every possible input.

Using hints and reference answers

Hints progress from orientation to the important operation and finally a precise repair. Open one at a time. Show Reference Solution reveals code without replacing your editor or recording a pass. Explain how your change produces the result instead of only copying it.

Reading test results and investigating errors

A PASS means the observed output or DOM behavior matched the named expectation. FAIL includes actual and expected observations. Function exercises call the declared entry function on their listed arguments; early lessons check console output. Empty collections and equality boundaries are important cases. An error, timeout or missing behavior check is not a successful result.

Debugging investigations

Choose 150 debugging investigations under Challenges. Record the first error and source position. For logic bugs, compare values and types before and after the suspected operation. A guard or timeout stops runaway worker code. The debugging tool replays supported snapshots; it does not pretend to be a universal breakpoint debugger.

HTML, CSS and JavaScript Build Studio

In Playground select HTML, CSS & JavaScript Build Studio. HTML creates labeled controls, CSS styles them and JavaScript registers interactions. Run Code rebuilds an isolated preview. Select a mobile preview width to inspect a narrow layout. Dynamic evaluation and imports are refused in this guarded DOM environment; worker practice supports wider JavaScript syntax.

Managing complete projects

Open Projects, choose one of 30 apps and select Open project. Inspect the architecture explanation and milestones. Run the finished source once, then Load starter to practice its missing setup. Check My Work performs actual authored interactions. Download my project ZIP exports your edited files; Download finished project ZIP exports the reference. Both include HTML, CSS, JavaScript and documentation.

Saving learning progress

Save or Save locally writes drafts, notes, results and preferences to this browser’s IndexedDB. Edits stay in memory while navigating but are not automatically durable. My Progress counts current passing checks separately from visits and explanations. Editing source invalidates current evidence until you rerun checks. Clearing browser storage can remove all local work.

Saving, loading and duplicating experiments

In Playground enter an Experiment name and select Save Experiment. Use Load experiment to choose a saved copy, then Load Experiment to restore it. Duplicate Experiment creates a new independent ID. Rename uses the name field. Delete asks for confirmation. The saved-copy list refreshes after saving, duplicating, renaming or deleting a record.

Downloading source and opening it

Download Code creates a JavaScript file containing your editor source. Pure-code exports include the trace or local fixture helper when needed. Async module source may use .mjs; serve it as a module over HTTP. For DOM work choose Download complete application ZIP, which includes the page and styling. Project ZIPs contain index.html, style.css, app.js, README.md and TESTING.md. Extract the ZIP and open index.html. Serve the folder over local HTTP for reliable modules, fetch or origin-specific storage. Source files in the academy ZIP are also available for continued editing.

Importing a backup

In My Progress select Export full JSON backup before moving devices or replacing data. Import backup accepts the academy’s version 1 JSON under 10 MB, validates its shape and asks before replacing the workspace. Imported code and notes remain, but check evidence is cleared until re-executed. Do not import unfamiliar code and run it without reviewing it.

Using AI as a learning companion

Each lesson has an optional AI learning companion with 11 assistance goals. Build contextual prompt includes your current source, actual console, lesson, level and prediction. Copy it to your chosen assistant only after checking for private data. Ask for a hint or explanation, then independently run and test any suggested change. The academy does not call AI.

Teaching and prepared demonstrations

Educator & demo scripts opens 20 prepared demonstrations. Each script links directly to the intended lesson and gives opening narration, exact actions, sample edits, expected observations and a closing question. Use the printable worksheets to record predictions, evidence and explanations. Suggested timings are planning estimates.

Troubleshooting

If nothing loads, use HTTP(S), upload every content module and serve .mjs with a JavaScript MIME type. If document is not defined, use the DOM Build Studio rather than a worker. If a preview’s selector returns null, inspect HTML IDs and run order. If storage is unavailable, export a backup. If code never finishes, Stop Execution and inspect loops or unresolved promises.

Frequently asked questions

Do I need AI? No. Does a code error damage my site? Practice code runs separately. Is saved work online? No, it belongs to this browser. Are API responses live? The supplied fixtureFetch adapter is local and labeled. Does a pass mean mastery? No: explain the operation and test an independent scenario. Can I skip lessons? Yes, prerequisites guide rather than lock you.

Glossary

The separate searchable glossary contains 250 unique entries with definitions, examples, misconceptions and related lessons. Open it as a reference, then return to your current learning page. The highlighted code and source walkthrough explain the main syntax used by each lesson.

Open the searchable glossary

Keyboard shortcuts

Tab and Shift+Tab move between controls. Native buttons activate with Enter or Space. Ctrl+Enter or Command+Enter runs editor code. Ctrl+] or Command+] inserts two spaces. Details disclosures and selectors use native keyboard interaction. The code editor does not trap Tab.

Accessibility

Controls use labels, native elements, visible focus and textual error/pass messages. Themes and code-size settings adapt reading preferences. Reduced-motion preferences disable decorative motion. Snapshot replay can be paused. Diagrams have corresponding textual values, and no required interaction relies solely on dragging or color. A full assistive-technology audit still requires target-browser testing.

Privacy and local storage

The academy itself requests no credentials and makes no AI calls. Pure code has no DOM access and runs in an opaque-origin sandbox worker with network blocked. Web previews have their own document and in-memory storage adapter. Exported apps run under the origin you choose and must be reviewed before use. Avoid secrets in code, notes, prompts or backups.

Exact button reference

ControlPurpose, result and recovery
Load ExampleLoads the example chosen in Prepared example after confirmation. Its expected result and walkthrough become the current reference; cancel keeps your editor unchanged.
Download complete application ZIPExports all current HTML, CSS, JavaScript and supporting module files from a DOM lesson, visual example, project or the Build Studio. Extract it and read README.md before running outside the academy.
Start HereReturns to the beginner introduction and its three starting routes. Drafts remain in memory; Save makes them durable.
LearnOpens the current lesson and searchable 20-module learning path. Choosing a lesson does not award completion.
PlaygroundOpens real code execution, the 40-object selector and optional Build Studio and assertion tools.
ChallengesOpens coding, debugging and knowledge-check catalogs filtered by module.
ProjectsOpens the catalog of 30 complete applications and their source archives.
My ProgressShows recorded results, bookmarks, recommendations, saved copies and backup controls.
HelpOpens the complete searchable guide separately so your current editor stays open.
Confirm changeApplies only the replacement or deletion described in the confirmation message. Keep a saved copy or backup before confirming destructive changes.
Keep my workCancels the pending replacement or deletion without changing current work.
Print demo scripts and worksheetsOpens the browser print dialog for the actual teaching scripts and worksheet. Save as PDF if supported by your browser.
Load square test exampleAsks before replacing source with a square function for the assertion lab. Set arguments and expectation before running.
Run assertionInvokes the named function with your JSON argument array, then compares the actual returned value using the chosen comparison. Results do not imply that every course case passed.
Download module example ZIPExports main.js, math.js, index.html and setup notes. Serve this example over HTTP because it uses real ES modules.
Save practice goalStores an optional target from 1 to 20 verified practice records per day. It does not invent a mastery score or pressure you to keep a streak.
Record explanation for reviewSaves a written response with no automated correctness judgment. Compare it with the rubric or ask a teacher.
Previous instructionShows the preceding authored presenter instruction without executing it.
Next instructionShows the next presenter instruction; perform its labeled screen action yourself.
Reset DemoAsks before replacing only this separate demo draft with its prepared reference. Lesson drafts remain separate.
Hide navigationToggles the site header, hero, navigation and lesson sidebar for recording. Activate it again to restore them.
Hide presenter notesToggles the current presenter script panel without changing source.
Hide reference solutionToggles the reference-answer region, if it has been revealed. It does not hide the editable teaching code.
Full screenRequests fullscreen for the document. Use browser controls or activate again to exit; unsupported requests report an error.
Run CodeRuns current source and reports actual output in Console; it does not save or publish. Stop or reset to recover.
Stop ExecutionStops a worker run or closes the DOM preview while preserving source. Run Code rebuilds it from your current files.
Reset CodeAsks before replacing source with the prepared starter. Export or save a copy first.
SaveWrites drafts and recorded evidence to this device. Export a portable backup before clearing browser data.
Step ThroughStarts replay of recorded supported snapshots. Run first if no recording exists.
Previous StepMoves to the previous recorded snapshot without re-executing.
Next StepMoves to the next recorded snapshot without re-executing.
PlayAutomatically advances recorded snapshots; stops at the end.
PauseStops replay without clearing its recording.
Clear ConsoleClears visible diagnostic text without changing source.
Copy CodeCopies current source; does not execute or save it.
Download CodeDownloads the current JavaScript file, including any unfinished changes.
Check My WorkRuns the prepared output or DOM behavior checks against your current code and displays per-check evidence.
Show Reference SolutionReveals authored working source for comparison. It neither replaces your source nor awards a pass.
Load repair exerciseAsks before replacing the editor with the intentionally broken lesson source.
Build the named greetingGenerates visible let/console.log code using the name field. Select Run Code afterward.
Save lesson and notesSaves the current lesson source, predictions, explanation and notes locally.
Open a related visual experimentOpens a tool linked to the current concept; save durable work before leaving the device.
Build contextual promptCombines the chosen goal with actual source and observed errors; sends nothing to AI.
Copy promptCopies the editable help request. Review private content before sharing.
Open selected objectLoads the chosen visual object with its prepared code and guidance.
Apply value to prepared sourceRebuilds an object’s source from a valid JSON literal. This replaces current source; save an independent copy before applying.
Parse and run expressionParses a supported literal expression into a tree, then executes the corresponding console expression in a worker.
Check answerAssesses the chosen knowledge-check option and explains the result. Select an answer first.
Open projectOpens the selected complete project and its prepared source.
Load starterAsks before replacing project files with the incomplete learning version.
Load finished sourceAsks before replacing edited project files with the reference implementation.
Download my project ZIPExports current edited HTML, CSS and JavaScript with project documentation.
Download finished project ZIPExports the authored finished files without changing your editor.
Save project draftStores current project files and notes in the browser.
Save ExperimentStores a named copy, updating the selected saved ID or creating a new one.
Duplicate ExperimentCreates a separate copy with a new ID, preserving the original.
Load ExperimentAsks before restoring selected saved code into Playground.
Rename ExperimentUses the name field to rename the selected saved record.
Delete ExperimentAsks before removing the selected saved record. Keep an exported backup for recovery.
Export full JSON backupDownloads version 1 workspace data including drafts, notes, results and preferences.
Reset all local learning dataAsks before removing every local draft and result. Export a backup first.
Bookmark lessonToggles a bookmark on the current lesson. Save to make it durable.
Next lesson →Opens the next numbered lesson without claiming completion.
← Previous lessonOpens the preceding lesson. Unsaved edits remain in memory during navigation.
Open recommended lessonOpens the transparent practice recommendation derived from recorded evidence.
Back to PlaygroundReturns to the playground chooser while keeping current edits in memory.
Save locallyWrites the entire current workspace to this browser.
Write Your First JavaScript CodeOpens Lesson 1 with exact beginner instructions.
Follow the 100-Lesson Learning PathOpens the last selected lesson and the module browser.
Explore the Interactive JavaScript PlaygroundOpens real source execution and the visual-object selector.
Review related lessonOpens the concept behind a question or challenge.
Read the related lessonOpens the instructional context of the current visual object.
Save attemptStores the debugging or challenge code and explanation.

Field and setting reference

Learning mode
Absolute Beginner expands teaching; Guided Practice starts new lessons with repair code; Independent Builder keeps the complete editors with collapsed detail. Switching preserves existing drafts.
Theme / Code font size
Select Light or Dark. Use 12–26px for editor text. Save to retain preferences.
Search lessons / Jump to lesson
Search titles and terms, or select any number. Filtering does not change current source.
Prepared example
Choose one of three complete programs, then click Load Example. Confirm replacement, run and compare with that example’s expected result.
Supporting module file
Lesson 91 and modular projects include an editable supporting .js file in the programming guide area. It is bundled for practice and exported as a real module. Keep the file name and named imports consistent.
Source code / HTML / CSS
Edit actual source for the selected environment. Keep matching selectors and IDs across files.
Preview width
Choose flexible desktop, 390px mobile or 768px tablet. It changes the iframe width, not its data.
Prepared value
A JSON literal such as 5, true, "Alex" or [1,2]. Invalid syntax is reported before source generation.
Test name / Function name / Arguments / Expected value / Comparison
Name an assertion, declare that function in Source code, supply a JSON argument array such as [4] and a JSON expected value such as 16. Choose deep JSON, strict primitive or text-contains comparison. A typo in the function name is a real execution error.
Expression
A literal expression such as 5 + 2 * 3. Names and function calls are rejected by this tool’s parser.
Activity type / Module
Choose coding, bugs or questions, then the relevant five-lesson module.
Project
Choose one of 30 complete apps, then Open project.
Prediction / Explain / Reflect / Notes
Store your reasoning. These are not automatically graded as correct.
Learning goal / Editable prompt
Select a help goal and build a prompt using current context. The prompt remains editable.
Experiment name / Load experiment
Name a saved copy or select one by its stored ID. Duplicate preserves both versions.
Import backup
A version 1 academy JSON file under 10 MB. Confirm replacement only after keeping your existing backup.

MDN JavaScript guide · Acorn parser source