react-native/React/Modules/RCTExceptionsManager.h

/**
 * Copyright (c) 2015-present, Facebook, Inc.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */

#import <Foundation/Foundation.h>

#import <React/RCTBridgeModule.h>

@protocol RCTExceptionsManagerDelegate <NSObject>

- (void)handleSoftJSExceptionWithMessage:(NSString *)message stack:(NSArray *)stack exceptionId:(NSNumber *)exceptionId;
- (void)handleFatalJSExceptionWithMessage:(NSString *)message stack:(NSArray *)stack exceptionId:(NSNumber *)exceptionId;

@optional
- (void)updateJSExceptionWithMessage:(NSString *)message stack:(NSArray *)stack exceptionId:(NSNumber *)exceptionId;

@end

@interface RCTExceptionsManager : NSObject <RCTBridgeModule>

- (instancetype)initWithDelegate:(id<RCTExceptionsManagerDelegate>)delegate;

- (void)reportSoftException:(NSString *)message stack:(NSArray<NSDictionary *> *)stack exceptionId:(nonnull NSNumber *)exceptionId;
- (void)reportFatalException:(NSString *)message stack:(NSArray<NSDictionary *> *)stack exceptionId:(nonnull NSNumber *)exceptionId;

@property (nonatomic, weak) id<RCTExceptionsManagerDelegate> delegate;

@property (nonatomic, assign) NSUInteger maxReloadAttempts;

@end
Second Updates from Mon 23 Mar - [ReactNative] Use deprecated ix in TabBarExample \| Amjad Masad - [ReactNative] Expanded license on obj-c files \| Christopher Chedeau - [ReactNative] Expanded license on js files \| Christopher Chedeau - [ReactNative] Fix React Devtools integration \| Alex Kotliarskyi - [Text] Account for font leading so descenders are not clipped \| James Ide - [ReactNative] Expanded license on js packager files \| Christopher Chedeau - more UIExplorer flow \| Basil Hosmer - [react-packager] Pick up package changes while running \| Amjad Masad - Added a graph view and a ReactNative metric that displays current queue and execution time for the JS thread. \| Bryce Redd - [ReactNative] Add NativeModules and DeviceEventEmitter to react-native exports \| Alex Kotliarskyi 2015-03-23 15:07:33 -07:00			`/**`
			`* Copyright (c) 2015-present, Facebook, Inc.`
			`*`
Update license headers for MIT license Summary: Includes React Native and its dependencies Fresco, Metro, and Yoga. Excludes samples/examples/docs. find: ^(?:( )\|( (?:[\~#]\|::))( )? )?Copyright (?:\(c\) )?(\d{4})\b.+Facebook[\s\S]+?BSD[\s\S]+?(?:this source tree\|the same directory)\.$ replace: $1$2$3Copyright (c) $4-present, Facebook, Inc.\n$2\n$1$2$3This source code is licensed under the MIT license found in the\n$1$2$3LICENSE file in the root directory of this source tree. Reviewed By: TheSavior, yungsters Differential Revision: D7007050 fbshipit-source-id: 37dd6bf0ffec0923bfc99c260bb330683f35553e 2018-02-16 18:24:55 -08:00			`* This source code is licensed under the MIT license found in the`
			`* LICENSE file in the root directory of this source tree.`
Second Updates from Mon 23 Mar - [ReactNative] Use deprecated ix in TabBarExample \| Amjad Masad - [ReactNative] Expanded license on obj-c files \| Christopher Chedeau - [ReactNative] Expanded license on js files \| Christopher Chedeau - [ReactNative] Fix React Devtools integration \| Alex Kotliarskyi - [Text] Account for font leading so descenders are not clipped \| James Ide - [ReactNative] Expanded license on js packager files \| Christopher Chedeau - more UIExplorer flow \| Basil Hosmer - [react-packager] Pick up package changes while running \| Amjad Masad - Added a graph view and a ReactNative metric that displays current queue and execution time for the JS thread. \| Bryce Redd - [ReactNative] Add NativeModules and DeviceEventEmitter to react-native exports \| Alex Kotliarskyi 2015-03-23 15:07:33 -07:00			`*/`
Initial commit 2015-01-29 17:10:49 -08:00
			`#import <Foundation/Foundation.h>`

Move all header imports to "<React/..>" Summary: To make React Native play nicely with our internal build infrastructure we need to properly namespace all of our header includes. Where previously you could do `#import "RCTBridge.h"`, you must now write this as `#import <React/RCTBridge.h>`. If your xcode project still has a custom header include path, both variants will likely continue to work, but for new projects, we're defaulting the header include path to `$(BUILT_PRODUCTS_DIR)/usr/local/include`, where the React and CSSLayout targets will copy a subset of headers too. To make Xcode copy headers phase work properly, you may need to add React as an explicit dependency to your app's scheme and disable "parallelize build". Reviewed By: mmmulani Differential Revision: D4213120 fbshipit-source-id: 84a32a4b250c27699e6795f43584f13d594a9a82 2016-11-23 07:47:52 -08:00			`#import <React/RCTBridgeModule.h>`
Initial commit 2015-01-29 17:10:49 -08:00
Updates from Thu Mar 12 - Fixed sticky section headers in ListView \| Nick Lockwood - [ReactNative] AppState cleanup, remove Subscribable, add in OSS examples \| Eric Vicenti - [react-packager] package.json cleanup (seperate packager into it's own package) \| Amjad Masad - [ReactNative] Move PushNotificationIOS to oss \| Tadeu Zagallo - [ReactNative] Fix shake gesture after RedBox is dismissed \| Alex Kotliarskyi - [catlyst\|madman] fix prop type warning \| Jiajie Zhu - [ReactNative] Remove Subscribable from TextInput \| Eric Vicenti - Unforked ExceptionsManager, AlertManager and AppState \| Nick Lockwood - [ReactNative\|MAdMan] Notification Subscribable \| Eric Vicenti - [ReactNative] OSS AsyncStorage with example \| Spencer Ahrens 2015-03-12 12:51:44 -07:00			`@protocol RCTExceptionsManagerDelegate <NSObject>`

Create RCTFatal for reporting fatal React events Summary: public Add RCTFatal for reporting fatal runtime conditions. This centralizes failure handling to one function and allows you to customize how they should be handled. RCTFatal will be logged to the console and as a redbox and will also be triggered by fatal exceptions coming from RCTExceptionsManager. Note that there is no RCTLogFatal, since just logging the fatal condition does not allow us to handle it consistently. Reviewed By: nicklockwood Differential Revision: D2615490 fb-gh-sync-id: 7d8e134419e10a8fb549297054ad955db3f6bee0 2015-11-05 12:19:56 -08:00			`- (void)handleSoftJSExceptionWithMessage:(NSString )message stack:(NSArray )stack exceptionId:(NSNumber *)exceptionId;`
			`- (void)handleFatalJSExceptionWithMessage:(NSString )message stack:(NSArray )stack exceptionId:(NSNumber *)exceptionId;`
Added lightweight generic annotations Summary: public Added lightweight genarics annotations to make the code more readable and help the compiler catch bugs. Fixed some type bugs and improved bridge validation in a few places. Reviewed By: javache Differential Revision: D2600189 fb-gh-sync-id: f81e22f2cdc107bf8d0b15deec6d5b83aacc5b56 2015-11-03 14:45:46 -08:00
Create RCTFatal for reporting fatal React events Summary: public Add RCTFatal for reporting fatal runtime conditions. This centralizes failure handling to one function and allows you to customize how they should be handled. RCTFatal will be logged to the console and as a redbox and will also be triggered by fatal exceptions coming from RCTExceptionsManager. Note that there is no RCTLogFatal, since just logging the fatal condition does not allow us to handle it consistently. Reviewed By: nicklockwood Differential Revision: D2615490 fb-gh-sync-id: 7d8e134419e10a8fb549297054ad955db3f6bee0 2015-11-05 12:19:56 -08:00			`@optional`
			`- (void)updateJSExceptionWithMessage:(NSString )message stack:(NSArray )stack exceptionId:(NSNumber *)exceptionId;`
Finish up the work to send through the error cookie Summary: - Includes the error cookie with soft exceptions as well since they too can be updated (requires tiny Android change too) - Passes the error cookie through instead of leaving it unused Closes https://github.com/facebook/react-native/pull/2198 Reviewed By: @svcscm Differential Revision: D2455391 Pulled By: @sahrens 2015-09-17 18:12:46 -07:00
Updates from Thu Mar 12 - Fixed sticky section headers in ListView \| Nick Lockwood - [ReactNative] AppState cleanup, remove Subscribable, add in OSS examples \| Eric Vicenti - [react-packager] package.json cleanup (seperate packager into it's own package) \| Amjad Masad - [ReactNative] Move PushNotificationIOS to oss \| Tadeu Zagallo - [ReactNative] Fix shake gesture after RedBox is dismissed \| Alex Kotliarskyi - [catlyst\|madman] fix prop type warning \| Jiajie Zhu - [ReactNative] Remove Subscribable from TextInput \| Eric Vicenti - Unforked ExceptionsManager, AlertManager and AppState \| Nick Lockwood - [ReactNative\|MAdMan] Notification Subscribable \| Eric Vicenti - [ReactNative] OSS AsyncStorage with example \| Spencer Ahrens 2015-03-12 12:51:44 -07:00			`@end`

2015-02-04 updates - Unbreak ReactKit \| Nick Lockwood - Refactor \| Nick Lockwood - [ReactNative] fix touch cancel behavior \| Spencer Ahrens - [ReactNative iOS] Fix responder issue with textInput \| Eric Vicenti - [ReactNative] README updates - file watching troubleshooting, one-time code drop -> currently private repo \| Spencer Ahrens - [ReactKit] Re-add README linebreaks \| Ben Alpert 2015-02-06 15:43:59 -08:00			`@interface RCTExceptionsManager : NSObject <RCTBridgeModule>`
Initial commit 2015-01-29 17:10:49 -08:00
Refactored module access to allow for lazy loading Summary: public The `bridge.modules` dictionary provides access to all native modules, but this API requires that every module is initialized in advance so that any module can be accessed. This diff introduces a better API that will allow modules to be initialized lazily as they are needed, and deprecates `bridge.modules` (modules that use it will still work, but should be rewritten to use `bridge.moduleClasses` or `-[bridge moduleForName/Class:` instead. The rules are now as follows: * Any module that overrides `init` or `setBridge:` will be initialized on the main thread when the bridge is created * Any module that implements `constantsToExport:` will be initialized later when the config is exported (the module itself will be initialized on a background queue, but `constantsToExport:` will still be called on the main thread. * All other modules will be initialized lazily when a method is first called on them. These rules may seem slightly arcane, but they have the advantage of not violating any assumptions that may have been made by existing code - any module written under the original assumption that it would be initialized synchronously on the main thread when the bridge is created should still function exactly the same, but modules that avoid overriding `init` or `setBridge:` will now be loaded lazily. I've rewritten most of the standard modules to take advantage of this new lazy loading, with the following results: Out of the 65 modules included in UIExplorer: * 16 are initialized on the main thread when the bridge is created * A further 8 are initialized when the config is exported to JS * The remaining 41 will be initialized lazily on-demand Reviewed By: jspahrsummers Differential Revision: D2677695 fb-gh-sync-id: 507ae7e9fd6b563e89292c7371767c978e928f33 2015-11-25 03:09:00 -08:00			`- (instancetype)initWithDelegate:(id<RCTExceptionsManagerDelegate>)delegate;`
Updates from Thu Mar 12 - Fixed sticky section headers in ListView \| Nick Lockwood - [ReactNative] AppState cleanup, remove Subscribable, add in OSS examples \| Eric Vicenti - [react-packager] package.json cleanup (seperate packager into it's own package) \| Amjad Masad - [ReactNative] Move PushNotificationIOS to oss \| Tadeu Zagallo - [ReactNative] Fix shake gesture after RedBox is dismissed \| Alex Kotliarskyi - [catlyst\|madman] fix prop type warning \| Jiajie Zhu - [ReactNative] Remove Subscribable from TextInput \| Eric Vicenti - Unforked ExceptionsManager, AlertManager and AppState \| Nick Lockwood - [ReactNative\|MAdMan] Notification Subscribable \| Eric Vicenti - [ReactNative] OSS AsyncStorage with example \| Spencer Ahrens 2015-03-12 12:51:44 -07:00
iOS C++: Add ICxxExceptionManager to access RCTExceptionsManager native module Summary: It is sometimes useful to report soft/fatal errors from C++ (native) to the same RCTExceptionsManager that is already handling JS exceptions. `ICxxExceptionManager` is an approach to provide such access, which impl provided for ObjC++. Reviewed By: shergin Differential Revision: D7224944 fbshipit-source-id: 8c607226b67851d46f4c787f5b6e6c8cb6a1afea 2018-03-18 23:49:51 -07:00			`- (void)reportSoftException:(NSString )message stack:(NSArray<NSDictionary > )stack exceptionId:(nonnull NSNumber )exceptionId;`
			`- (void)reportFatalException:(NSString )message stack:(NSArray<NSDictionary > )stack exceptionId:(nonnull NSNumber )exceptionId;`

Cleanup initialization of native modules in FBReactModule Reviewed By: shergin Differential Revision: D5111768 fbshipit-source-id: 9ad682b51ad34516576b6403220bb7d2870e0192 2017-05-26 04:09:00 -07:00			`@property (nonatomic, weak) id<RCTExceptionsManagerDelegate> delegate;`

Updates from Fri 10 Apr - Implemented response headers when using `XMLHttpRequest` \| Nick Lockwood - [ReactNative] Don't redbox on flow config errors \| Spencer Ahrens - [ReactNative] Fix suggestions in TextInput when setting value prop \| Spencer Ahrens - Link LinkingIOS in SampleApp \| Nick Lockwood - unify use of password and secureTextEntry for TextInput \| Nick Lockwood - Added random js queue+execution time sampling in react native \| Bryce Redd - [react_native] JS files from D1980312: [react_native] Fix webview \| Andrei Coman - [react-packager] Correct module extension regexp \| Amjad Masad - [react-packager] Implement the browser field package.json spec \| Amjad Masad - [ReactNative] Bring back crash reporting \| Alex Kotliarskyi - Remove duplicate word \| Nick Lockwood - NavigatorIOS navigationBarHidden property support \| Nick Lockwood - [Scroll] Include content insets in scroll events \| Nick Lockwood 2015-04-10 01:33:10 -07:00			`@property (nonatomic, assign) NSUInteger maxReloadAttempts;`

Initial commit 2015-01-29 17:10:49 -08:00			`@end`