Verify the Nitro Modules Version

Oct 13, 2025 by talynt.org 16 views

What's Happening?

When using the Nitro version 0.25.0 to create a View Component, and adding a union type property in the attributes, an exception occurs on iOS devices. This issue is specific to iOS and does not affect Android devices.

Reproduceable Code

The following code snippet demonstrates the issue:

### ts
export type ColorScheme = 'dark' | 'light';
export interface NitroModulesViewBugProps extends HybridViewProps {
  color: ColorScheme;
}

export interface NitroModulesViewBugMethods extends HybridViewMethods {}

export type NitroModulesViewBug = HybridView<NitroModulesViewBugProps>;

### swift
class NitroModulesViewBug: HybridNitroModulesViewBugSpec {
    var view: UIView = UIView(frame: .zero)
  
    var color: ColorScheme = .light
  
    func beforeUpdate() {}
    func afterUpdate() {}
}

Relevant Log Output

The log output for this issue is too long to be displayed here.

Device

The issue was reproduced on an iPhone 16 Prop (18.3) Simulator.

Nitro Modules Version

The Nitro Modules version used to reproduce this issue is 0.25.0.

Nitrogen Version

The Nitrogen version used to reproduce this issue is also 0.25.0.

Can You Reproduce This Issue in the Nitro Example App?

Yes, the issue can be reproduced in the Example app.

Additional Information

I am using Expo.
I am using Nitrogen (nitro-codegen).
I have read and followed the Troubleshooting Guide.
I created a reproduction PR to reproduce this issue here in the nitro repo. (See Contributing for more information)
I searched for similar issues in this repository and found none.

Troubleshooting Steps

To troubleshoot this issue, follow these steps:

Verify the Nitro Modules Version: Ensure that you are using the latest version of Nitro Modules.
Check the Nitrogen Version: Verify that you are using the latest version of Nitrogen.
Review the Code: Carefully review the code to ensure that it is correct and does not contain any errors.
Test on Different Devices: Test the app on different devices to see if the issue is specific to iOS or if it affects other platforms as well.
Search for Similar Issues: Search for similar issues in the Nitro repository to see if anyone else has encountered the same problem.

Conclusion

In conclusion, the issue of iOS throwing an exception if a property in a View Component contains the union type is a specific problem that affects only iOS devices. To troubleshoot this issue, follow the steps outlined above and ensure that you are using the latest versions of Nitro Modules and Nitrogen. If the issue persists, create a reproduction PR to help the Nitro team identify and fix the problem.

Troubleshooting Guide

If you are experiencing issues with Nitro, follow the Troubleshooting Guide to help resolve the problem.

Contributing

If you would like to contribute to the Nitro repository, see the Contributing guide for more information.

Similar Issues

If you have encountered a similar issue, search for similar issues in this repository to see if anyone else has encountered the same problem.

Nitro Modules Version

To ensure that you are using the latest version of Nitro Modules, follow these steps:

Update Nitro Modules: Run the command npm install @margelo/nitro-modules to update Nitro Modules to the latest version.
Verify the Version: Verify that you are using the latest version of Nitro Modules by running the command npm ls @margelo/nitro-modules.

Nitrogen Version

To ensure that you are using the latest version of Nitrogen, follow these steps:

Update Nitrogen: Run the command npm install @margelo/nitrogen to update Nitrogen to the latest version.
Verify the Version: Verify that you are using the latest version of Nitrogen by running the command npm ls @margelo/nitrogen.

Code Review

To ensure that your code is correct and does not contain any errors, follow these steps:

Review the Code: Carefully review the code to ensure that it is correct and does not contain any errors.
Test the Code: Test the code to ensure that it works as expected.

Device Testing

To ensure that your app works on different devices, follow these steps:

Test on Different Devices: Test the app on different devices to see if the issue is specific to iOS or if it affects other platforms as well.

Search for Similar Issues

To see if anyone else has encountered the same problem, follow these steps:

Search for Similar Issues: Search for similar issues in the Nitro repository to see if anyone else has encountered the same problem.
Q&A: iOS Throws an Exception if a Property in a View Component Contains the Union Type =====================================================================================

Q: What is the issue with iOS throwing an exception if a property in a View Component contains the union type?

A: The issue is that when using the Nitro version 0.25.0 to create a View Component, and adding a union type property in the attributes, an exception occurs on iOS devices. This issue is specific to iOS and does not affect Android devices.

Q: What is the cause of this issue?

A: The cause of this issue is not yet clear, but it is believed to be related to the way that Nitro handles union types on iOS devices.

Q: How can I reproduce this issue?

A: To reproduce this issue, follow these steps:

Create a new View Component: Create a new View Component using the Nitro version 0.25.0.
Add a union type property: Add a union type property to the View Component.
Run the app on an iOS device: Run the app on an iOS device to see if the exception occurs.

Q: What are the symptoms of this issue?

A: The symptoms of this issue are:

An exception occurs on iOS devices when running the app.
The exception is related to the union type property in the View Component.

Q: How can I troubleshoot this issue?

A: To troubleshoot this issue, follow these steps:

Verify the Nitro Modules Version: Ensure that you are using the latest version of Nitro Modules.
Check the Nitrogen Version: Verify that you are using the latest version of Nitrogen.
Review the Code: Carefully review the code to ensure that it is correct and does not contain any errors.
Test on Different Devices: Test the app on different devices to see if the issue is specific to iOS or if it affects other platforms as well.
Search for Similar Issues: Search for similar issues in the Nitro repository to see if anyone else has encountered the same problem.

Q: What are the possible solutions to this issue?

A: The possible solutions to this issue are:

Update Nitro Modules: Update Nitro Modules to the latest version.
Update Nitrogen: Update Nitrogen to the latest version.
Review the Code: Review the code to ensure that it is correct and does not contain any errors.
Test on Different Devices: Test the app on different devices to see if the issue is specific to iOS or if it affects other platforms as well.

Q: How can I contribute to the solution of this issue?

A: To contribute to the solution of this issue, follow these steps:

Create a reproduction PR: Create a reproduction PR to help the Nitro team identify and fix the problem.
Search for Similar Issues: Search for similar issues in the Nitro repository to see if anyone else has encountered the same problem.
Provide Feedback: Provide feedback to the Nitro team on the issue and any potential solutions.

Q: Where can I find more information about this issue?

A: You can find more information about this issue in the following resources:

Nitro Repository: The Nitro repository contains information about the issue, including the reproduction PR and any potential solutions.
Nitro Documentation: The Nitro documentation contains information about the issue, including troubleshooting steps and potential solutions.
Nitro Community: The Nitro community contains information about the issue, including feedback and potential solutions from other developers.