using System;

using JavaScriptEngineSwitcher.Core;

namespace React

{

/// <summary>

/// Handles creation of JavaScript engines. All methods are thread-safe.

/// </summary>

public interface IJavaScriptEngineFactory

{

/// <summary>

/// Gets the JavaScript engine for the current thread. It is recommended to use

/// <see cref="GetEngine"/> instead, which will pool/reuse engines.

/// </summary>

/// <returns>The JavaScript engine</returns>

IJsEngine GetEngineForCurrentThread();

/// <summary>

/// Disposes the JavaScript engine for the current thread. This should only be used

/// if the engine was acquired through <see cref="GetEngineForCurrentThread"/>.

/// </summary>

void DisposeEngineForCurrentThread();

/// <summary>

/// Gets a JavaScript engine from the pool.

/// </summary>

/// <returns>The JavaScript engine</returns>

IJsEngine GetEngine();

/// <summary>

/// Returns an engine to the pool so it can be reused

/// </summary>

/// <param name="engine">Engine to return</param>

void ReturnEngineToPool(IJsEngine engine);

}

}