Introduction

Safari Technology Preview 241 brings a host of improvements and new features for web developers and early adopters. This guide will walk you through installing or updating to this release, highlight key changes, and show you how to verify the fixes. Whether you're a front‑end developer testing new CSS capabilities or an accessibility specialist ensuring robust screen reader support, this step‑by‑step tutorial covers everything you need.

What You Need

• A Mac running macOS Tahoe or macOS Sequoia (the build is compatible only with these versions).
• An existing installation of Safari Technology Preview (if you already have it, you’ll update; if not, you’ll need to download the latest version from the Apple Developer website).
• Internet connection to download the update or fresh installer.
• Basic knowledge of web technologies (HTML, CSS, Accessibility) to test the new features.

Step 1: Check Your Current Safari Technology Preview Version

Before proceeding, confirm you are on an older build. Open Safari Technology Preview, then click Safari Technology Preview in the menu bar → About Safari Technology Preview. Note the version number. If it’s earlier than 241, you need to update. If you don’t have it installed, skip to Step 3.

Step 2: Update Safari Technology Preview via System Settings

If you already have Safari Technology Preview installed, the update is delivered through macOS Software Update:

1. Click the Apple icon () in the top‑left corner and choose System Settings.
2. Go to General → Software Update.
3. The system will check for updates. Look for “Safari Technology Preview 241” – it should appear here.
4. Click Update Now and authenticate with your administrator password.
5. Once the update finishes, launch Safari Technology Preview. You can confirm the new version by revisiting About Safari Technology Preview.

Note: If you don’t see the update, ensure your Mac is running macOS Tahoe or Sequoia and that you’ve enabled automatic updates for developer previews.

Step 3: Fresh Installation (If Not Already Installed)

If you’re a new user, download and install Safari Technology Preview:

1. Go to the Apple Developer Safari Downloads page (requires free Apple Developer account).
2. Find Safari Technology Preview 241 for macOS Tahoe or macOS Sequoia.
3. Download the disk image (.dmg) and open it.
4. Drag the Safari Technology Preview app into your Applications folder.
5. Launch it from the Applications folder or Launchpad.
6. When prompted, authenticate with your administrator credentials.

After installation, the browser will be ready for testing.

Step 4: Understand the Changes Included

Release 241 contains WebKit changes from commit 309287@main to 310186@main. This rewrite focuses on new capabilities and resolved issues that affect your development workflow.

Accessibility Fixes

• speechSynthesis.cancel() no longer removes utterances queued after the cancel call. (Bug 46151521) – Test by queueing multiple TTS items and cancelling the first.
• MathML table rows/cells now compute correct bounding boxes, improving screen reader placement. (Bug 172851295)
• Comboboxes properly forward focus to aria-activedescendant, enabling assistive technologies to interact with list items. (Bug 172931277)
• aria-owns is now respected when computing accessible name from element content. (Bug 173249317)

Animation Fixes

• animation-fill-mode correctly applies viewport‑based units after viewport resize. (Bug 80075191)

CSS New Features

• Stretch keyword added for box-sizing properties (e.g., box-sizing: stretch). (Bug 132539604)
• CSS scroll anchoring is now stable, preventing unexpected page jumps when content above the viewport loads. (Bug 171840378)

CSS Fixes

• U+2028 LINE SEPARATOR now renders as a forced line break as per spec. (Bug 88470339)
• outline-offset no longer inflates for outline: auto on macOS. (Bug 94116168)
• font-family serialization preserves quotes for family names matching CSS‑wide keywords or generic families. (Bug 125334960)
• Fonts are not downloaded if no characters in the document fall within their unicode-range. (Bug 140674753)
• Flex items with percentage‑height images shrink correctly. (Bug 156902823)
• View Transition snapshots store colors correctly (non‑sRGB colors are no longer incorrectly convereted). (Bug 167634138)
• contain: layout no longer forces slower layouts when all siblings create their own formatting context. (Bug 171545381)
• Underlines are not split when a ruby base expands due to long ruby text. (Bug 171653095)
• Changing color-scheme now repaints the background of composited iframes. (Bug 171658244)
• Nested children of a popover element render correctly with position: absolute. (Bug 171735933)
• color: initial resolves to the correct color in dark appearance mode. (Bug 172320282)
• An element with display: contents establishes an anchor scope when using anchor-scope. (Bug 172355302)
• Media queries resolution regression fixed (no more false negatives). (Bug not listed but implied)

Step 5: Test the New Features and Fixes

To verify the updates, create test pages or use the Web Inspector:

• For stretch box-sizing, set box-sizing: stretch and check the box model.
• Enable CSS scroll anchoring by adding overflow-anchor: auto to a scrolling container and loading dynamic content above the fold.
• Test accessibility fixes using VoiceOver: Tab into a combobox and ensure list items are announced.
• For animation-fill-mode, create an element with viewport‑based units and resize the window.

Use the Develop menu → Show Web Inspector to inspect computed styles and debug any issues.

Conclusion & Tips

• Keep a backup of your previous Safari Technology Preview version (you can copy the app before updating).
• Test your existing projects after updating to catch any regressions early.
• Use Responsive Design Mode (Develop → Enter Responsive Design Mode) to simulate different viewports when testing viewport‑based units.
• Enable the Develop menu if it’s not visible: Safari Technology Preview → Settings → Advanced → Show Develop menu in menu bar.
• Stay tuned for future previews – each release includes dozens of changes; reading the release notes (like this guide) helps you stay ahead.

By following these steps, you have successfully updated to Safari Technology Preview 241 and can now leverage the latest WebKit improvements in your development workflow.