Data.Foreign

data Foreign :: Type

A type for foreign data.

Foreign data is data from any external unknown or unreliable source, for which it cannot be guaranteed that the runtime representation conforms to that of any particular type.

Suitable applications of Foreign are

• To represent responses from web services
• To integrate with external JavaScript libraries.

data ForeignError

A type for foreign type errors

Constructors

• ForeignError String
• TypeMismatch String String
• ErrorAtIndex Int ForeignError
• ErrorAtProperty String ForeignError
• JSONError String

Instances

• Eq ForeignError
• Ord ForeignError
• Show ForeignError

type MultipleErrors = NonEmptyList ForeignError

A type for accumulating multiple ForeignErrors.

renderForeignError :: ForeignError -> String

type F = Except MultipleErrors

An error monad, used in this library to encode possible failures when dealing with foreign data.

The Alt instance for Except allows us to accumulate errors, unlike Either, which preserves only the last error.

toForeign :: forall a. a -> Foreign

Coerce any value to the a Foreign value.

unsafeFromForeign :: forall a. Foreign -> a

Unsafely coerce a Foreign value.

typeOf :: Foreign -> String

Read the Javascript type of a value

tagOf :: Foreign -> String

Read the Javascript tag of a value.

This function wraps the Object.toString method.

unsafeReadTagged :: forall a. String -> Foreign -> F a

Unsafely coerce a Foreign value when the value has a particular tagOf value.

isNull :: Foreign -> Boolean

Test whether a foreign value is null

isUndefined :: Foreign -> Boolean

Test whether a foreign value is undefined

isArray :: Foreign -> Boolean

Test whether a foreign value is an array

readString :: Foreign -> F String

Attempt to coerce a foreign value to a String.

readChar :: Foreign -> F Char

Attempt to coerce a foreign value to a Char.

readBoolean :: Foreign -> F Boolean

Attempt to coerce a foreign value to a Boolean.

readNumber :: Foreign -> F Number

Attempt to coerce a foreign value to a Number.

readInt :: Foreign -> F Int

Attempt to coerce a foreign value to an Int.

readArray :: Foreign -> F (Array Foreign)

Attempt to coerce a foreign value to an array.

readNull :: Foreign -> F (Maybe Foreign)

readUndefined :: Foreign -> F (Maybe Foreign)

readNullOrUndefined :: Foreign -> F (Maybe Foreign)

fail :: forall a. ForeignError -> F a

Throws a failure error in F.