Skip to content

Sheffield | 26-ITP-Jan | Mahmoud Shaabo | Sprint 3 | Alarm Clock App #1155

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mahmoudshaabo1984 wants to merge 2 commits into
base: main
Choose a base branch
from
+77 −2
Open

Sheffield | 26-ITP-Jan | Mahmoud Shaabo | Sprint 3 | Alarm Clock App #1155

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
57ab58c
feat: implement alarm clock functionality
mahmoudshaabo1984 Mar 31, 2026
04f8254
fix: address PR review feedback and implement DRY principle
mahmoudshaabo1984 Apr 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
77 changes: 76 additions & 1 deletion Sprint-3/alarmclock/alarmclock.js
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,79 @@
function setAlarm() {}
// Stores the interval ID so we can clear it later
let interval = null;

// Helper function: format seconds as mm:ss and update the display
// This keeps the time-display logic in ONE place (CJ feedback: avoid repetition)
function updateTimeDisplay(totalSeconds) {
const mins = String(Math.floor(totalSeconds / 60)).padStart(2, "0");
const secs = String(totalSeconds % 60).padStart(2, "0");
document.getElementById("timeRemaining").innerText =
"Time Remaining: " + mins + ":" + secs;
}

function setAlarm() {
// Clear any previously running countdown
clearInterval(interval);

// Reset background to default
document.body.style.backgroundColor = "";

Comment on lines +14 to +19
Copy link
Copy Markdown
Contributor

@cjyuan cjyuan Apr 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently when starting a new countdown, the application does not always return to a clean initial state,
which can lead to inconsistent behaviour between runs. In addition to resetting the countdown and the background color, what else should also be reset? (Hint: a user may not click the "Stop" button first before starting a new count down.)

// Stop any currently playing alarm sound before starting a new countdown
// (the user may not click "Stop" first before setting a new alarm)
pauseAlarm();

// Read the input value and convert it to a plain integer (total seconds)
let totalSeconds = parseInt(document.getElementById("alarmSet").value);
Copy link
Copy Markdown
Contributor

@cjyuan cjyuan Apr 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some integer values or unusual input can still make your app behave abnormally. Can you figure out a way to prevent that from happening?


// Validate input: reject NaN, negative numbers, or empty field
if (isNaN(totalSeconds) || totalSeconds < 0) {
document.getElementById("timeRemaining").innerText =
"Please enter a valid number of seconds (0 or above).";
return;
}

// If input is 0, trigger the alarm immediately instead of waiting 1 second
if (totalSeconds === 0) {
updateTimeDisplay(0);
document.body.style.backgroundColor = "red";
playAlarm();
return;
}

// Display the initial time using the helper function
updateTimeDisplay(totalSeconds);

// Start the countdown: setInterval calls the callback every 1000 ms (1 second)
interval = setInterval(function () {
totalSeconds--; // subtract 1 second

if (totalSeconds <= 0) {
// Stop the interval when time runs out
clearInterval(interval);

updateTimeDisplay(0);

// Change background colour to signal the alarm
document.body.style.backgroundColor = "red";

// Trigger the alarm sound (defined below the DO NOT EDIT line)
playAlarm();
return;
}

// Update the display with the new remaining time
updateTimeDisplay(totalSeconds);
}, 1000);
}

// Make the Stop button also stop the countdown (not just the sound)
// Uses DOMContentLoaded so the button element exists before we attach the listener
// This adds a SECOND listener without modifying the original code below
document.addEventListener("DOMContentLoaded", function () {
document.getElementById("stop").addEventListener("click", function () {
clearInterval(interval);
document.body.style.backgroundColor = "";
});
});

// DO NOT EDIT BELOW HERE

Expand Down
2 changes: 1 addition & 1 deletion Sprint-3/alarmclock/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" href="style.css" />
<title>Title here</title>
<title>Alarm clock app</title>
</head>
<body>
<div class="centre">
Expand Down