Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sindresorhus/ExceptionCatcher
Catch Objective-C exceptions in Swift
https://github.com/sindresorhus/ExceptionCatcher
exception-handler exceptions objective-c swift-package
Last synced: about 2 months ago
JSON representation
Catch Objective-C exceptions in Swift
- Host: GitHub
- URL: https://github.com/sindresorhus/ExceptionCatcher
- Owner: sindresorhus
- License: mit
- Created: 2020-01-04T13:27:32.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2023-07-12T11:31:28.000Z (over 1 year ago)
- Last Synced: 2024-04-14T09:51:36.960Z (8 months ago)
- Topics: exception-handler, exceptions, objective-c, swift-package
- Language: Swift
- Homepage:
- Size: 11.7 KB
- Stars: 124
- Watchers: 9
- Forks: 16
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
- fucking-awesome-swift - ExceptionCatcher - Catch Objective-C exceptions. (Libs / Utility)
- awesome-swift - ExceptionCatcher - Catch Objective-C exceptions in Swift (Utility [🔝](#readme))
- awesome-swift - ExceptionCatcher - Catch Objective-C exceptions. (Libs / Utility)
README
# ExceptionCatcher
> Catch [Objective-C exceptions](https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/Exceptions/Tasks/HandlingExceptions.html) in Swift
There are many Cocoa APIs that can throw exceptions that cannot be caught in Swift (`NSKeyedUnarchiver`, `NSTask`, `NSObject#value(forKey:)`, etc). This package wraps an Objective-C exception handler to make it possible to catch such exceptions.
*The ability to catch exceptions should really be built into Swift. If you agree, duplicate [this](https://github.com/feedback-assistant/reports/issues/74) Feedback Assistant report.*
## Install
Add the following to `Package.swift`:
```swift
.package(url: "https://github.com/sindresorhus/ExceptionCatcher", from: "2.0.0")
```
[Or add the package in Xcode.](https://developer.apple.com/documentation/xcode/adding_package_dependencies_to_your_app)
## Usage
```swift
import Foundation
import ExceptionCatcher
final class Foo: NSObject {}
do {
let value = try ExceptionCatcher.catch {
return Foo().value(forKey: "nope")
}
print("Value:", value)
} catch {
print("Error:", error.localizedDescription)
//=> Error: [valueForUndefinedKey:]: this class is not key value coding-compliant for the key nope.
debugPrint(error)
/*
Error Domain=NSUnknownKeyException Code=0 "[valueForUndefinedKey:]: this class is not key value coding-compliant for the key nope." UserInfo={CallStackSymbols=(
0 CoreFoundation 0x00007fff361798ab __exceptionPreprocess + 250
1 libobjc.A.dylib 0x00007fff6c3ea805 objc_exception_throw + 48
2 CoreFoundation 0x00007fff361a230c -[NSException raise] + 9
3 Foundation 0x00007fff388f86c4 -[NSObject(NSKeyValueCoding) valueForUndefinedKey:] + 222
4 Foundation 0x00007fff3876f8fd -[NSObject(NSKeyValueCoding) valueForKey:] + 317
5 ExceptionCatcherTests 0x0000000103402ef6 $s21ExceptionCatcherTestsAAC9testCatchyyKFypSgyXEfU1_ + 118
…
*/
}
```
## Related
- [Defaults](https://github.com/sindresorhus/Defaults) - Swifty and modern UserDefaults
- [Preferences](https://github.com/sindresorhus/Preferences) - Add a preferences window to your macOS app
- [LaunchAtLogin](https://github.com/sindresorhus/LaunchAtLogin) - Add “ Launch at Login” functionality to your macOS app
- [More…](https://github.com/search?q=user%3Asindresorhus+language%3Aswift)