Skip to content

docs: add wrapKey parity guide and browser equivalence tests #272

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
HamdaanAliQuatil wants to merge 4 commits into
base: master
Choose a base branch
from
+901 −5
Open

docs: add wrapKey parity guide and browser equivalence tests #272

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
1d923fb
docs: add wrapKey parity guide and browser equivalence tests
HamdaanAliQuatil May 7, 2026
0a4fc24
test: mark wrap-key parity test experimental and exclude it from CI
HamdaanAliQuatil May 7, 2026
4b23b95
test: mark wrap-key parity test experimental and exclude it from CI
HamdaanAliQuatil May 7, 2026
6bb2a20
Merge branch 'wrap-key-docs-and-tests' of https://github.com/google/w…
HamdaanAliQuatil May 7, 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
8 changes: 4 additions & 4 deletions .github/workflows/test.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ jobs:
sudo apt-get install -y ninja-build libgtk-3-dev
flutter config --no-analytics
- run: flutter pub get
- run: xvfb-run dart test -p vm,chrome,firefox -c dart2js,dart2wasm --coverage ./coverage
- run: xvfb-run dart test --exclude-tags experimental -p vm,chrome,firefox -c dart2js,dart2wasm --coverage ./coverage
- run: xvfb-run flutter test integration_test/webcrypto_test.dart -d linux
working-directory: ./example
# Report collected coverage
Expand All @@ -57,7 +57,7 @@ jobs:
- uses: actions/checkout@v4
- uses: dart-lang/setup-dart@v1
- run: dart pub get --no-example
- run: xvfb-run dart test -p vm,chrome,firefox -c dart2js,dart2wasm
- run: xvfb-run dart test --exclude-tags experimental -p vm,chrome,firefox -c dart2js,dart2wasm
macos:
name: MacOS desktop / Chrome
runs-on: macos-15 # Test with xcode 16
Expand All @@ -72,7 +72,7 @@ jobs:
run: |
flutter config --no-analytics
- run: flutter pub get
- run: dart test -p vm,chrome -c dart2js,dart2wasm
- run: dart test --exclude-tags experimental -p vm,chrome -c dart2js,dart2wasm
- run: flutter test integration_test/webcrypto_test.dart -d macos --timeout 5m
working-directory: ./example
windows:
Expand All @@ -90,7 +90,7 @@ jobs:
run: |
flutter config --no-analytics
- run: flutter pub get
- run: dart test -p vm,chrome,firefox
- run: dart test --exclude-tags experimental -p vm,chrome,firefox
- run: flutter test integration_test/webcrypto_test.dart -d windows
working-directory: ./example
ios:
Expand Down
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ Web Cryptography APIs see `doc/webcrypto-parity.md`.

* `deriveKey` is not supported, however, keys can always be created from
`derivedBits` which is supported.
* `wrapKey` is not supported, however, keys can be exported an encrypted.
* `wrapKey` is not supported, however, keys can be exported and encrypted.
* `unwrapKey` is not supported, however, keys can be decrypted and imported.
* `AES-KW` is not supported because it does not support `encrypt`/`decrypt`.

Expand Down
3 changes: 3 additions & 0 deletions doc/webcrypto-parity.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -112,6 +112,9 @@ export+encrypt and decrypt+import and it has complex typing, this package shall
omit this functionality. Adding these operations in the future only impact
developers who have custom implementations of `CryptoKey` subclasses.

See also [wrap-key.md](wrap-key.md) for a tutorial showing how to express these
operations with the current API.

## Notes on the `'AES-KW'` Algorithm
The `'AES-KW'` algorithm only supports the `crypto.sutble.wrapKey` and
`crypto.sutble.unwrapKey` operations, which we have argued to omit in the
Expand Down
Loading
Loading