JavaScriptKit/Sources/JavaScriptKit/JSBridgedType.swift at main · tearitco/JavaScriptKit

46 lines (37 loc) · 1.57 KB

/// Use this protocol when your type has no single JavaScript class.
/// For example, a union type of multiple classes or primitive values.
public protocol JSBridgedType: JSValueCompatible, CustomStringConvertible {
    /// This is the value your class wraps.
    var value: JSValue { get }

    /// If your class is incompatible with the provided value, return `nil`.
    init?(from value: JSValue)
}

extension JSBridgedType {
    public static func construct(from value: JSValue) -> Self? {
        return Self.init(from: value)
    }

    public func jsValue() -> JSValue { value }

    public var description: String { value.description }
}

/// Conform to this protocol when your Swift class wraps a JavaScript class.
public protocol JSBridgedClass: JSBridgedType {
    /// The constructor function for the JavaScript class
    static var constructor: JSFunction { get }

    /// The JavaScript object wrapped by this instance.
    /// You may assume that `jsObject instanceof Self.constructor == true`
    var jsObject: JSObject { get }

    /// Create an instance wrapping the given JavaScript object.
    /// You may assume that `jsObject instanceof Self.constructor`
    init(unsafelyWrapping jsObject: JSObject)
}

extension JSBridgedClass {
    public var value: JSValue { jsObject.jsValue() }
    public init?(from value: JSValue) {
        guard let object = value.object else { return nil }
        self.init(from: object)
    }

    public init?(from object: JSObject) {
        guard object.isInstanceOf(Self.constructor) else { return nil }
        self.init(unsafelyWrapping: object)
    }
}

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Expand file tree

Search code, repositories, users, issues, pull requests...

FilesExpand file tree

JSBridgedType.swift

Latest commit

History

JSBridgedType.swift

File metadata and controls

Expand file tree