Gjsify LogoGjsify Logo

All the fields in the #UhmServer structure are private and should never be accessed directly.

Hierarchy

Index

Constructors

Properties

address: string

Address of the local mock server if it's running, or %NULL otherwise. This will be non-%NULL between calls to uhm_server_run() and uhm_server_stop(). The address is a physical IP address, e.g. 127.0.0.1.

This should not normally need to be passed into client code under test, unless the code references IP addresses specifically. The mock server runs a DNS resolver which automatically redirects client requests for known domain names to this address (#UhmServer:resolver).

enableLogging: boolean

%TRUE if network traffic should be logged to a trace file (specified by calling uhm_server_start_trace()). This operates independently of whether traffic is online or being handled locally by the mock server. Use this in conjunction with #UhmServer:enable-online to either log online traffic, or replay logged traffic locally.

enableOnline: boolean

%TRUE if network traffic should reach the Internet as normal; %FALSE to redirect it to the local mock server. Use this in conjunction with #UhmServer:enable-logging to either log online traffic, or replay logged traffic locally.

gTypeInstance: TypeInstance
port: number

Port of the local mock server if it's running, or 0 otherwise. This will be non-0 between calls to uhm_server_run() and uhm_server_stop().

It is intended that this port be passed into the client code under test, to substitute for the default HTTPS port (443) which it would otherwise use.

resolver: Uhm.Resolver

Mock resolver used to redirect HTTP requests from specified domain names to the local mock server instance. This will always be set while the server is running (between calls to uhm_server_run() and uhm_server_stop()), and is %NULL otherwise.

Use the resolver specified in this property to add domain names which are expected to be requested by the current trace. Domain names not added to the resolver will be rejected by the mock server. The set of domain names in the resolver will be reset when uhm_server_stop() is called.

tlsCertificate: TlsCertificate

TLS certificate for the mock server to use when serving HTTPS pages. If this is non-%NULL, the server will always use HTTPS. If it is %NULL, the server will always use HTTP. The TLS certificate may be changed after constructing the #UhmServer, but changes to the property will not take effect until the next call to uhm_server_run().

A certificate and private key may be generated by executing: openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -nodes. These files may then be used to construct a #GTlsCertificate by calling g_tls_certificate_new_from_files().

Alternatively, a default #GTlsCertificate which wraps a dummy certificate (not signed by any certificate authority) may be set by calling uhm_server_set_default_tls_certificate(). This may be used as the #UhmServer:tls-certificate if the code under test has no specific requirements of the certificate used by the mock server it's tested against.

traceDirectory: Gio.File

Directory relative to which all trace files specified in calls to uhm_server_start_trace() will be resolved. This is not used for any other methods, but must be non-%NULL if uhm_server_start_trace() is called.

$gtype: GType<Uhm.Server>
name: string

Methods

  • Creates a binding between source_property on source and target_property on target.

    Whenever the source_property is changed the target_property is updated using the same value. For instance:

      g_object_bind_property (action, "active", widget, "sensitive", 0);
    

    Will result in the "sensitive" property of the widget #GObject instance to be updated with the same value of the "active" property of the action #GObject instance.

    If flags contains %G_BINDING_BIDIRECTIONAL then the binding will be mutual: if target_property on target changes then the source_property on source will be updated as well.

    The binding will automatically be removed when either the source or the target instances are finalized. To remove the binding without affecting the source and the target you can just call g_object_unref() on the returned #GBinding instance.

    Removing the binding by calling g_object_unref() on it must only be done if the binding, source and target are only used from a single thread and it is clear that both source and target outlive the binding. Especially it is not safe to rely on this if the binding, source or target can be finalized from different threads. Keep another reference to the binding and use g_binding_unbind() instead to be on the safe side.

    A #GObject can have multiple bindings.

    Parameters

    • sourceProperty: string

      the property on source to bind

    • target: GObject.Object

      the target #GObject

    • targetProperty: string

      the property on target to bind

    • flags: BindingFlags

      flags to pass to #GBinding

    Returns Binding

  • Creates a binding between source_property on source and target_property on target, allowing you to set the transformation functions to be used by the binding.

    This function is the language bindings friendly version of g_object_bind_property_full(), using #GClosures instead of function pointers.

    Parameters

    • sourceProperty: string

      the property on source to bind

    • target: GObject.Object

      the target #GObject

    • targetProperty: string

      the property on target to bind

    • flags: BindingFlags

      flags to pass to #GBinding

    • transformTo: TClosure<any, any>

      a #GClosure wrapping the transformation function from the source to the target, or %NULL to use the default

    • transformFrom: TClosure<any, any>

      a #GClosure wrapping the transformation function from the target to the source, or %NULL to use the default

    Returns Binding

  • compareMessagesRemoveFilter(filterId: number): void
  • Remove a #UhmServer:compare-messages filter function installed previously by calling something like uhm_server_filter_ignore_parameter_values().

    It is an error to call this function with an invalid filter_id.

    Parameters

    • filterId: number

      filter ID returned by the filter addition function

    Returns void

  • connect(sigName: "compare-messages", callback: Server_CompareMessagesSignalCallback): number
  • connect(sigName: "handle-message", callback: Server_HandleMessageSignalCallback): number
  • connect(sigName: "notify::address", callback: ((...args: any[]) => void)): number
  • connect(sigName: "notify::enable-logging", callback: ((...args: any[]) => void)): number
  • connect(sigName: "notify::enable-online", callback: ((...args: any[]) => void)): number
  • connect(sigName: "notify::port", callback: ((...args: any[]) => void)): number
  • connect(sigName: "notify::resolver", callback: ((...args: any[]) => void)): number
  • connect(sigName: "notify::tls-certificate", callback: ((...args: any[]) => void)): number
  • connect(sigName: "notify::trace-directory", callback: ((...args: any[]) => void)): number
  • connect(sigName: string, callback: ((...args: any[]) => void)): number
  • Parameters

    Returns number

  • Parameters

    Returns number

  • Parameters

    • sigName: "notify::address"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns number

  • Parameters

    • sigName: "notify::enable-logging"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns number

  • Parameters

    • sigName: "notify::enable-online"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns number

  • Parameters

    • sigName: "notify::port"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns number

  • Parameters

    • sigName: "notify::resolver"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns number

  • Parameters

    • sigName: "notify::tls-certificate"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns number

  • Parameters

    • sigName: "notify::trace-directory"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns number

  • Parameters

    • sigName: string
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns number

  • emit(sigName: "compare-messages", actualMessage: Soup.Message, actualClient: ClientContext, ...args: any[]): void
  • emit(sigName: "handle-message", client: ClientContext, ...args: any[]): void
  • emit(sigName: "notify::address", ...args: any[]): void
  • emit(sigName: "notify::enable-logging", ...args: any[]): void
  • emit(sigName: "notify::enable-online", ...args: any[]): void
  • emit(sigName: "notify::port", ...args: any[]): void
  • emit(sigName: "notify::resolver", ...args: any[]): void
  • emit(sigName: "notify::tls-certificate", ...args: any[]): void
  • emit(sigName: "notify::trace-directory", ...args: any[]): void
  • emit(sigName: string, ...args: any[]): void
  • endTrace(): void
  • Convenience function to finish logging to or reading from a trace file previously passed to uhm_server_start_trace() or uhm_server_start_trace_full().

    If #UhmServer:enable-online is %FALSE, this will shut down the mock server (as if uhm_server_stop() had been called).

    Returns void

  • filterIgnoreParameterValues(parameterNames: string[]): number
  • Install a #UhmServer:compare-messages filter function which will override the default comparison function to one which ignores differences in the values of the given query parameter_names. The named parameters must still be present in the query, however.

    The filter will remain in place for the lifetime of the #UhmServer, until uhm_server_compare_messages_remove_filter() is called with the returned filter ID.

    Note that currently only one of the installed comparison functions will be used. This may change in future.

    Parameters

    • parameterNames: string[]

      %NULL-terminated array of parameter names to ignore

    Returns number

  • forceFloating(): void
  • This function is intended for #GObject implementations to re-enforce a [floating][floating-ref] object reference. Doing this is seldom required: all #GInitiallyUnowneds are created with a floating reference which usually just needs to be sunken by calling g_object_ref_sink().

    Returns void

  • freezeNotify(): void
  • Increases the freeze count on object. If the freeze count is non-zero, the emission of "notify" signals on object is stopped. The signals are queued until the freeze count is decreased to zero. Duplicate notifications are squashed so that at most one #GObject::notify signal is emitted for each property modified while the object is frozen.

    This is necessary for accessors that modify multiple properties to prevent premature notification while the object is still being modified.

    Returns void

  • getAddress(): string
  • Gets the value of the #UhmServer:address property.

    Returns string

  • getData(key?: string): object
  • Gets a named field from the objects table of associations (see g_object_set_data()).

    Parameters

    • Optional key: string

      name of the key for that association

    Returns object

  • getEnableLogging(): boolean
  • Gets the value of the #UhmServer:enable-logging property.

    Returns boolean

  • getEnableOnline(): boolean
  • Gets the value of the #UhmServer:enable-online property.

    Returns boolean

  • getPort(): number
  • Gets the value of the #UhmServer:port property.

    Returns number

  • getProperty(propertyName?: string, value?: any): void
  • Gets a property of an object.

    The value can be:

    • an empty #GValue initialized by %G_VALUE_INIT, which will be automatically initialized with the expected type of the property (since GLib 2.60)
    • a #GValue initialized with the expected type of the property
    • a #GValue initialized with a type to which the expected type of the property can be transformed

    In general, a copy is made of the property contents and the caller is responsible for freeing the memory by calling g_value_unset().

    Note that g_object_get_property() is really intended for language bindings, g_object_get() is much more convenient for C programming.

    Parameters

    • Optional propertyName: string

      the name of the property to get

    • Optional value: any

      return location for the property value

    Returns void

  • getQdata(quark: number): object
  • This function gets back user data pointers stored via g_object_set_qdata().

    Parameters

    • quark: number

      A #GQuark, naming the user data pointer

    Returns object

  • getv(names: string[], values: any[]): void
  • Gets n_properties properties for an object. Obtained properties will be set to values. All properties must be valid. Warnings will be emitted and undefined behaviour may result if invalid properties are passed in.

    Parameters

    • names: string[]

      the names of each property to get

    • values: any[]

      the values of each property to get

    Returns void

  • isFloating(): boolean
  • Synchronously loads the given trace_file of network messages, ready to simulate a network conversation by matching requests against the file and returning the associated responses. Call uhm_server_run() to start the mock server afterwards.

    Loading the trace file may be cancelled from another thread using cancellable.

    On error, error will be set and the state of the #UhmServer will not change. A #GIOError will be set if there is a problem reading the trace file.

    Parameters

    Returns void

  • Asynchronous version of uhm_server_load_trace(). In callback, call uhm_server_load_trace_finish() to complete the operation.

    Parameters

    Returns void

  • Finishes an asynchronous operation started by uhm_server_load_trace_async().

    On error, error will be set and the state of the #UhmServer will not change. See uhm_server_load_trace() for details on the error domains used.

    Parameters

    • result: AsyncResult

      asynchronous operation result passed to the callback

    Returns void

  • notify(propertyName: string): void
  • Emits a "notify" signal for the property property_name on object.

    When possible, eg. when signaling a property change from within the class that registered the property, you should use g_object_notify_by_pspec() instead.

    Note that emission of the notify signal may be blocked with g_object_freeze_notify(). In this case, the signal emissions are queued and will be emitted (in reverse order) when g_object_thaw_notify() is called.

    Parameters

    • propertyName: string

      the name of a property installed on the class of object.

    Returns void

  • Emits a "notify" signal for the property specified by pspec on object.

    This function omits the property name lookup, hence it is faster than g_object_notify().

    One way to avoid using g_object_notify() from within the class that registered the properties, and using g_object_notify_by_pspec() instead, is to store the GParamSpec used with g_object_class_install_property() inside a static array, e.g.:

      enum
    {
    PROP_0,
    PROP_FOO,
    PROP_LAST
    };

    static GParamSpec *properties[PROP_LAST];

    static void
    my_object_class_init (MyObjectClass *klass)
    {
    properties[PROP_FOO] = g_param_spec_int ("foo", "Foo", "The foo",
    0, 100,
    50,
    G_PARAM_READWRITE);
    g_object_class_install_property (gobject_class,
    PROP_FOO,
    properties[PROP_FOO]);
    }

    and then notify a change on the "foo" property with:

      g_object_notify_by_pspec (self, properties[PROP_FOO]);
    

    Parameters

    • pspec: ParamSpec

      the #GParamSpec of a property installed on the class of object.

    Returns void

  • off(sigName: "compare-messages", callback: Server_CompareMessagesSignalCallback): EventEmitter
  • off(sigName: "handle-message", callback: Server_HandleMessageSignalCallback): EventEmitter
  • off(sigName: "notify::address", callback: ((...args: any[]) => void)): EventEmitter
  • off(sigName: "notify::enable-logging", callback: ((...args: any[]) => void)): EventEmitter
  • off(sigName: "notify::enable-online", callback: ((...args: any[]) => void)): EventEmitter
  • off(sigName: "notify::port", callback: ((...args: any[]) => void)): EventEmitter
  • off(sigName: "notify::resolver", callback: ((...args: any[]) => void)): EventEmitter
  • off(sigName: "notify::tls-certificate", callback: ((...args: any[]) => void)): EventEmitter
  • off(sigName: "notify::trace-directory", callback: ((...args: any[]) => void)): EventEmitter
  • off(sigName: string, callback: ((...args: any[]) => void)): EventEmitter
  • Parameters

    Returns EventEmitter

  • Parameters

    Returns EventEmitter

  • Parameters

    • sigName: "notify::address"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns EventEmitter

  • Parameters

    • sigName: "notify::enable-logging"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns EventEmitter

  • Parameters

    • sigName: "notify::enable-online"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns EventEmitter

  • Parameters

    • sigName: "notify::port"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns EventEmitter

  • Parameters

    • sigName: "notify::resolver"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns EventEmitter

  • Parameters

    • sigName: "notify::tls-certificate"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns EventEmitter

  • Parameters

    • sigName: "notify::trace-directory"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns EventEmitter

  • Parameters

    • sigName: string
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns EventEmitter

  • on(sigName: "compare-messages", callback: Server_CompareMessagesSignalCallback, after?: boolean): EventEmitter
  • on(sigName: "handle-message", callback: Server_HandleMessageSignalCallback, after?: boolean): EventEmitter
  • on(sigName: "notify::address", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • on(sigName: "notify::enable-logging", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • on(sigName: "notify::enable-online", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • on(sigName: "notify::port", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • on(sigName: "notify::resolver", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • on(sigName: "notify::tls-certificate", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • on(sigName: "notify::trace-directory", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • on(sigName: string, callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • Parameters

    Returns EventEmitter

  • Parameters

    Returns EventEmitter

  • Parameters

    • sigName: "notify::address"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::enable-logging"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::enable-online"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::port"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::resolver"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::tls-certificate"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::trace-directory"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: string
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • once(sigName: "compare-messages", callback: Server_CompareMessagesSignalCallback, after?: boolean): EventEmitter
  • once(sigName: "handle-message", callback: Server_HandleMessageSignalCallback, after?: boolean): EventEmitter
  • once(sigName: "notify::address", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • once(sigName: "notify::enable-logging", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • once(sigName: "notify::enable-online", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • once(sigName: "notify::port", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • once(sigName: "notify::resolver", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • once(sigName: "notify::tls-certificate", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • once(sigName: "notify::trace-directory", callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • once(sigName: string, callback: ((...args: any[]) => void), after?: boolean): EventEmitter
  • Parameters

    Returns EventEmitter

  • Parameters

    Returns EventEmitter

  • Parameters

    • sigName: "notify::address"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::enable-logging"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::enable-online"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::port"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::resolver"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::tls-certificate"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: "notify::trace-directory"
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • Parameters

    • sigName: string
    • callback: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    • Optional after: boolean

    Returns EventEmitter

  • receivedMessageChunk(messageChunk: string, messageChunkLength: number): void
  • Indicates to the mock server that a single new line of a message was received from the real server. The message line may be appended to the current trace file if logging is enabled (#UhmServer:enable-logging is %TRUE), adding a newline character at the end. If logging is disabled but online mode is enabled (#UhmServer:enable-online is %TRUE), the message line will be compared to the next expected line in the existing trace file. Otherwise, this function is a no-op.

    On failure, error will be set and the #UhmServer state will remain unchanged apart from the parse state machine, which will remain in the state reached after parsing message_chunk. A %G_IO_ERROR will be returned if writing to the trace file failed. If in comparison mode and the received message chunk corresponds to an unexpected message in the trace file, a %UHM_SERVER_ERROR will be returned.

    In common cases where message log data only needs to be passed to a #UhmServer and not (for example) logged to an application-specific file or the command line as well, it is simpler to use uhm_server_received_message_chunk_from_soup(), passing it directly to soup_logger_set_printer(). See the documentation for uhm_server_received_message_chunk_from_soup() for details.

    Parameters

    • messageChunk: string

      single line of a message which was received

    • messageChunkLength: number

      length of message_chunk in bytes

    Returns void

  • receivedMessageChunkWithDirection(direction: number, data: string, dataLength: number): void
  • Convenience version of uhm_server_received_message_chunk() which takes the message direction and data separately, as provided by libsoup in a #SoupLoggerPrinter callback.

    UhmServer *mock_server; SoupSession *session; SoupLogger *logger;

    static void soup_log_printer (SoupLogger *logger, SoupLoggerLogLevel level, char direction, const char data, gpointer user_data) { / Pass the data to libuhttpmock. */ UhmServer *mock_server = UHM_SERVER (user_data); uhm_server_received_message_chunk_with_direction (mock_server, direction, data, strlen (data), NULL); }

    mock_server = uhm_server_new (); session = soup_session_new ();

    logger = soup_logger_new (SOUP_LOGGER_LOG_BODY, -1); soup_logger_set_printer (logger, (SoupLoggerPrinter) soup_log_printer, g_object_ref (mock_server), g_object_unref); soup_session_add_feature (session, SOUP_SESSION_FEATURE (logger)); g_object_unref (logger);

    /* Do something with mock_server here. */

    Parameters

    • direction: number

      single character indicating the direction of message transmission

    • data: string

      single line of a message which was received

    • dataLength: number

      length of data in bytes

    Returns void

  • Increases the reference count of object.

    Since GLib 2.56, if GLIB_VERSION_MAX_ALLOWED is 2.56 or greater, the type of object will be propagated to the return type (using the GCC typeof() extension), so any casting the caller needs to do on the return type must be explicit.

    Returns GObject.Object

  • Increase the reference count of object, and possibly remove the [floating][floating-ref] reference, if object has a floating reference.

    In other words, if the object is floating, then this call "assumes ownership" of the floating reference, converting it to a normal reference by clearing the floating flag while leaving the reference count unchanged. If the object is not floating, then this call adds a new normal reference increasing the reference count by one.

    Since GLib 2.56, the type of object will be propagated to the return type under the same conditions as for g_object_ref().

    Returns GObject.Object

  • run(): void
  • Runs the mock server, binding to a loopback TCP/IP interface and preparing a HTTPS server which is ready to accept requests. The TCP/IP address and port number are chosen randomly out of the loopback addresses, and are exposed as #UhmServer:address and #UhmServer:port once this function has returned. A #UhmResolver (exposed as #UhmServer:resolver) is set as the default #GResolver while the server is running.

    The server is started in a worker thread, so this function returns immediately and the server continues to run in the background. Use uhm_server_stop() to shut it down.

    This function always succeeds.

    Returns void

  • runDispose(): void
  • Releases all references to other objects. This can be used to break reference cycles.

    This function should only be called from object system implementations.

    Returns void

  • setData(key: string, data?: object): void
  • Each object carries around a table of associations from strings to pointers. This function lets you set an association.

    If the object already had an association with that name, the old association will be destroyed.

    Internally, the key is converted to a #GQuark using g_quark_from_string(). This means a copy of key is kept permanently (even after object has been finalized) — so it is recommended to only use a small, bounded set of values for key in your program, to avoid the #GQuark storage growing unbounded.

    Parameters

    • key: string

      name of the key

    • Optional data: object

      data to associate with that key

    Returns void

  • Sets the value of the #UhmServer:tls-certificate property to the default TLS certificate built in to libuhttpmock. This default certificate is not signed by any certificate authority, and contains minimal metadata details. It may be used by clients which have no special certificate requirements; clients which have special requirements should construct a custom #GTlsCertificate and pass it to uhm_server_set_tls_certificate().

    Returns TlsCertificate

  • setEnableLogging(enableLogging: boolean): void
  • Sets the value of the #UhmServer:enable-logging property.

    Parameters

    • enableLogging: boolean

      %TRUE to log client network traffic to a trace file; %FALSE otherwise

    Returns void

  • setEnableOnline(enableOnline: boolean): void
  • Sets the value of the #UhmServer:enable-online property.

    Parameters

    • enableOnline: boolean

      %TRUE to not intercept and handle network connections from client code; %FALSE otherwise

    Returns void

  • setExpectedDomainNames(domainNames: string[]): void
  • Set the domain names which are expected to have requests made of them by the client code interacting with this #UhmServer. This is a convenience method which calls uhm_resolver_add_A() on the server’s #UhmResolver for each of the domain names listed in domain_names. It associates them with the server’s current IP address, and automatically updates the mappings if the IP address or resolver change.

    Note that this will reset all records on the server’s #UhmResolver, replacing all of them with the provided domain_names.

    It is safe to add further domain names to the #UhmResolver in a callback for the #GObject::notify signal for #UhmServer:resolver; that signal is emitted after the resolver is cleared and these domain_names are added.

    Parameters

    • domainNames: string[]

      %NULL-terminated array of domain names to expect, or %NULL to not expect any

    Returns void

  • setProperty(propertyName: string, value?: any): void
  • Sets a property on an object.

    Parameters

    • propertyName: string

      the name of the property to set

    • Optional value: any

      the value

    Returns void

  • Sets the value of the #UhmServer:tls-certificate property.

    Parameters

    • tlsCertificate: TlsCertificate

      TLS certificate for the server to use; or %NULL to serve HTTP only

    Returns void

  • setTraceDirectory(traceDirectory: Gio.File): void
  • Sets the value of the #UhmServer:trace-directory property.

    Parameters

    • traceDirectory: Gio.File

      a directory to load/store trace files from, or %NULL to unset it

    Returns void

  • startTrace(traceName: string): void
  • Starts a mock server which follows the trace file of filename trace_name in the #UhmServer:trace-directory directory. See uhm_server_start_trace_full() for further documentation.

    This function has undefined behaviour if #UhmServer:trace-directory is %NULL.

    On failure, error will be set and the #UhmServer state will remain unchanged. See uhm_server_start_trace_full() for details of the error domains used.

    Parameters

    • traceName: string

      name of the trace

    Returns void

  • startTraceFull(traceFile: Gio.File): void
  • Convenience function to start logging to or reading from the given trace_file, depending on the values of #UhmServer:enable-logging and #UhmServer:enable-online.

    If #UhmServer:enable-logging is %TRUE, a log handler will be set up to redirect all client network activity into the given trace_file. If trace_file already exists, it will be overwritten.

    If #UhmServer:enable-online is %FALSE, the given trace_file is loaded using uhm_server_load_trace() and then a mock server is started using uhm_server_run().

    On failure, error will be set and the #UhmServer state will remain unchanged. A #GIOError will be set if logging is enabled (#UhmServer:enable-logging) and there is a problem writing to the trace file; or if a trace needs to be loaded and there is a problem reading from the trace file.

    Parameters

    • traceFile: Gio.File

      a trace file to load

    Returns void

  • stealData(key?: string): object
  • Remove a specified datum from the object's data associations, without invoking the association's destroy handler.

    Parameters

    • Optional key: string

      name of the key

    Returns object

  • stealQdata(quark: number): object
  • This function gets back user data pointers stored via g_object_set_qdata() and removes the data from object without invoking its destroy() function (if any was set). Usually, calling this function is only required to update user data pointers with a destroy notifier, for example:

    void
    object_add_to_user_list (GObject *object,
    const gchar *new_string)
    {
    // the quark, naming the object data
    GQuark quark_string_list = g_quark_from_static_string ("my-string-list");
    // retrieve the old string list
    GList *list = g_object_steal_qdata (object, quark_string_list);

    // prepend new string
    list = g_list_prepend (list, g_strdup (new_string));
    // this changed 'list', so we need to set it again
    g_object_set_qdata_full (object, quark_string_list, list, free_string_list);
    }
    static void
    free_string_list (gpointer data)
    {
    GList *node, *list = data;

    for (node = list; node; node = node->next)
    g_free (node->data);
    g_list_free (list);
    }

    Using g_object_get_qdata() in the above example, instead of g_object_steal_qdata() would have left the destroy function set, and thus the partial string list would have been freed upon g_object_set_qdata_full().

    Parameters

    • quark: number

      A #GQuark, naming the user data pointer

    Returns object

  • stop(): void
  • Stops a mock server started by calling uhm_server_run(). This shuts down the server's worker thread and unbinds it from its TCP/IP socket.

    This unloads any trace file loaded by calling uhm_server_load_trace() (or its asynchronous counterpart). It also resets the set of domain names loaded into the #UhmServer:resolver.

    This function always succeeds.

    Returns void

  • thawNotify(): void
  • Reverts the effect of a previous call to g_object_freeze_notify(). The freeze count is decreased on object and when it reaches zero, queued "notify" signals are emitted.

    Duplicate notifications for each property are squashed so that at most one #GObject::notify signal is emitted for each property, in the reverse order in which they have been queued.

    It is an error to call this function when the freeze count is zero.

    Returns void

  • unloadTrace(): void
  • Unloads the current trace file of network messages, as loaded by uhm_server_load_trace() or uhm_server_load_trace_async().

    Returns void

  • unref(): void
  • Decreases the reference count of object. When its reference count drops to 0, the object is finalized (i.e. its memory is freed).

    If the pointer to the #GObject may be reused in future (for example, if it is an instance variable of another object), it is recommended to clear the pointer to %NULL rather than retain a dangling pointer to a potentially invalid #GObject instance. Use g_clear_object() for this.

    Returns void

  • watchClosure(closure: TClosure<any, any>): void
  • This function essentially limits the life time of the closure to the life time of the object. That is, when the object is finalized, the closure is invalidated by calling g_closure_invalidate() on it, in order to prevent invocations of the closure with a finalized (nonexisting) object. Also, g_object_ref() and g_object_unref() are added as marshal guards to the closure, to ensure that an extra reference count is held on object during invocation of the closure. Usually, this function will be called on closures that use this object as closure data.

    Parameters

    • closure: TClosure<any, any>

      #GClosure to watch

    Returns void

  • compatControl(what: number, data: object): number
  • errorQuark(): number
  • Find the #GParamSpec with the given name for an interface. Generally, the interface vtable passed in as g_iface will be the default vtable from g_type_default_interface_ref(), or, if you know the interface has already been loaded, g_type_default_interface_peek().

    Parameters

    • gIface: TypeInterface

      any interface vtable for the interface, or the default vtable for the interface

    • propertyName: string

      name of a property to look up.

    Returns ParamSpec

  • Add a property to an interface; this is only useful for interfaces that are added to GObject-derived types. Adding a property to an interface forces all objects classes with that interface to have a compatible property. The compatible property could be a newly created #GParamSpec, but normally g_object_class_override_property() will be used so that the object class only needs to provide an implementation and inherits the property description, default value, bounds, and so forth from the interface property.

    This function is meant to be called from the interface's default vtable initialization function (the class_init member of #GTypeInfo.) It must not be called after after class_init has been called for any object types implementing this interface.

    If pspec is a floating reference, it will be consumed.

    Parameters

    • gIface: TypeInterface

      any interface vtable for the interface, or the default vtable for the interface.

    • pspec: ParamSpec

      the #GParamSpec for the new property

    Returns void

  • Lists the properties of an interface.Generally, the interface vtable passed in as g_iface will be the default vtable from g_type_default_interface_ref(), or, if you know the interface has already been loaded, g_type_default_interface_peek().

    Parameters

    • gIface: TypeInterface

      any interface vtable for the interface, or the default vtable for the interface

    Returns ParamSpec[]

  • Creates a new instance of a #GObject subtype and sets its properties.

    Construction parameters (see %G_PARAM_CONSTRUCT, %G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values.

    Parameters

    • objectType: GType<unknown>

      the type id of the #GObject subtype to instantiate

    • parameters: GObject.Parameter[]

      an array of #GParameter

    Returns GObject.Object

  • Convenience version of uhm_server_received_message_chunk() which can be passed directly to soup_logger_set_printer() to forward all libsoup traffic logging to a #UhmServer. The #UhmServer must be passed to soup_logger_set_printer() as its user data.

    UhmServer *mock_server; SoupSession *session; SoupLogger *logger;

    mock_server = uhm_server_new (); session = soup_session_new ();

    logger = soup_logger_new (SOUP_LOGGER_LOG_BODY, -1); soup_logger_set_printer (logger, uhm_server_received_message_chunk_from_soup, g_object_ref (mock_server), g_object_unref); soup_session_add_feature (session, SOUP_SESSION_FEATURE (logger)); g_object_unref (logger);

    /* Do something with mock_server here. */

    Parameters

    • logger: Soup.Logger

      a #SoupLogger

    • level: Soup.LoggerLogLevel

      the detail level of this log message

    • direction: number

      the transmission direction of the message

    • data: string

      message data

    • userData: object

      user data passed to the #SoupLogger, or %NULL

    Returns void

Legend

  • Module
  • Object literal
  • Variable
  • Function
  • Function with type parameter
  • Index signature
  • Type alias
  • Type alias with type parameter
  • Enumeration
  • Enumeration member
  • Property
  • Method
  • Interface
  • Interface with type parameter
  • Constructor
  • Property
  • Method
  • Index signature
  • Class
  • Class with type parameter
  • Constructor
  • Property
  • Method
  • Accessor
  • Index signature
  • Inherited constructor
  • Inherited property
  • Inherited method
  • Inherited accessor
  • Protected property
  • Protected method
  • Protected accessor
  • Private property
  • Private method
  • Private accessor
  • Static property
  • Static method