sindresorhus / exceptioncatcher

Catch Objective-C exceptions in Swift

ExceptionCatcher

Catch Objective-C exceptions 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 Feedback Assistant report.

Install

Add the following to Package.swift:

.package(url: "https://github.com/sindresorhus/ExceptionCatcher", from: "2.0.0")

Or add the package in Xcode.

Usage

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 - Swifty and modern UserDefaults
• Preferences - Add a preferences window to your macOS app
• LaunchAtLogin - Add “ Launch at Login” functionality to your macOS app
• More…

exceptioncatcher's Issues

SPM Warning with deployment target iOS 13+

Our current deployment target: iOS 13.0
And we get the following error for the added Swift package:

The iOS Simulator deployment target 'IPHONEOS_DEPLOYMENT_TARGET' is set to 8.0, but the range of supported deployment target versions is 9.0 to 14.0.99.

A version bump to v9 in the Package.swift could solve the problem. If you mind I can open a PR for that.

complied xcframwork throws "missing required module 'internal'"

I have my own framework and that is now dependent on ExceptionCatcher.

After compiling my framework to xcframework and then using into test app, before distribution is throwing error at build time with the message `missing required module "internal"'

Do you know how can I get this internal module of exceptionCatcher into the xcframework?

Carthage support

You should add Carthage support to this framework