Skip to content

Latest commit

 

History

History
3864 lines (3541 loc) · 189 KB

ChangeLog.md

File metadata and controls

3864 lines (3541 loc) · 189 KB
Raw

This document describes changes between tagged Emscripten SDK versions.

Note that in the compiler, version numbering is used as the mechanism to invalidate internal compiler caches, so version numbers do not necessarily reflect the amount of changes between versions.

To browse or download snapshots of old tagged versions, visit https://github.com/emscripten-core/emscripten/releases.

Not all changes are documented here. In particular, new features, user-oriented fixes, options, command-line parameters, usage changes, deprecations, significant internal modifications and optimizations etc. generally deserve a mention. To examine the full set of changes between versions, visit the link to full changeset diff at the end of each section.

See docs/process.md for how version tagging works.

Current Trunk

  • Pass linker flags dirctly to wasm-ld by default. We still filter out certain flags explcitly. If there are other flags that it would be useful for us to ignore we can add them to the list of ignored flags.
  • Optionally support 2GB+ heap sizes. To do this we make the JS code have unsigned pointers (we need all 32 bits in them now), which can slightly increase code size (>>> instead of >>). This only happens when the heap size may be over 2GB, which you must opt into explicity, by setting MAXIMUM_MEMORY to a higher value (i.e. by default you do not get support for 2GB+ heaps). See #10601
  • --llvm-lto flag is now ignored when using the upstream llvm backend. With the upstream backend LTO is controlled via -flto.
  • Require format string for emscripten_log.
  • Program entry points without extensions are now shell scripts rather than python programs. See #10729. This means that python emcc no longer works. However emcc, emcc.py and python emcc.py all continue to work. The reason for this change is that #!/usr/bin/env python is no longer portable since the python symlink was dropped from Ubuntu 20.04.
  • New EM_IMPORT macro to mark C/C++ symbols as imported from outside the module (i.e. imported from JS). Currently we still default to assuming that all undefined symbols can come from JS, but in the future we hope to mark such symbols explicitly to allow the linker to report on genuinely undefined symbols.

v1.39.11: 03/20/2020

  • The default c++ version is no longer fixed at c++03. We now fall back to clang's default which is currently c++14.
  • Remove arc4random function form library.js. This is a BSD-only library function. Anyone requiring BSD compat should be able to use something like https://libbsd.freedesktop.org/.
  • Change the meaning of ASYNCIFY_IMPORTS: it now contains only new imports you add, and does not need to contain the list of default system imports like emscripten_sleep. There is no harm in providing them, though, so this is not a breaking change.
  • Enable DWARF support: When compiling with -g, normal DWARF emitting happens, and when linking with -g we preserve that and update it. This is a change from before, where we assumed DWARF was unneeded and did not emit it, so this can increase the size of debug builds (i.e. builds compiling and/or linking with -g). This change is necessary for full debugging support, that is, to be able to build with -g and use a debugger. Before this change only the -gforce_dwarf flag enabled DWARF; that flag is now removed. If you want the old behavior, build your object files with -gline-tables-only (that will only add line table info, which is just enough for things like source maps and does not include full debug info). For more info and background see #10325.
  • Remove hacks from memset handling, in particular, in the wasm backend, completely remove the JS version of memset from the JS library and from DEFAULT_LIBRARY_FUNCS_TO_INCLUDE. The regular C version will be linked in from compiler_rt normally. A noticeable difference you may see is that a JS library cannot add a __dep to memset - deps only work for JS library functions, but now we only have the regular C version. If you hit that issue, just add _memset to EXPORTED_FUNCTIONS (or adjust deps_info.json).
  • Minimal runtime code size optimizations, see #10725, #10724, #10663.
  • wasm2js fix for a long-existing but very rare correctness bug, see #10682.
  • Use atomics in musl lock/unlock in pthreads builds, which may fix very rare pthreads + stdio issues (none have been reported though). See #10670.

v1.39.10: 03/09/2020

  • Fix a SIMD regression in 1.39.9 (#10658).
  • Fix emscripten_atomic_exchange_u8,16,32,64 (#10657).
  • Switch bzip2 to an emscripten-ports mirror.

v1.39.9: 03/05/2020

  • Add support for -Wall, -Werror, -w, -Wno-error=, -Werror=, for controlling internal emscripten errors. The behavior of these flags matches the gcc/clang counterparts.
  • Rename TOTAL_MEMORY to INITIAL_MEMORY and WASM_MEM_MAX to MAXIMUM_MEMORY, which are more accurate and match wasm conventions. The old names are still supported as aliases.
  • Updated of libc++abi and libc++ to llvm 9.0.0 (#10510)
  • Refactor syscall interface: Syscalls are no longer variadic (except those that are inherently such as open) and no longer take the syscall number as arg0. This should be invisible to most users but will effect any external projects that try to implement/emulate the emscripten syscall interface. See #10474
  • Removed src/library_vr.js, as it was outdated and nonfunctional, and the WebVR specification has been obsoleted in favor of the upcoming WebXR specification. (#10460)
  • Deprecate WASM_OBJECT_FILES setting. There are many standard ways to enable bitcode objects (-flto, -flto=full, -flto=thin, -emit-llvm).
  • Removed EmscriptenWebGLContextAttributes::preferLowPowerToHighPerformance option that has become unsupported by WebGL. Access EmscriptenWebGLContextAttributes::powerPreference instead. (#10505)
  • When implementing forwarding function aliases in JS libraries, either the alias or the target function must contain a signature annotation. (#10550)
  • Add an check in Asyncify builds with ASSERTIONS that we do not have compiled code on the stack when starting to rewind, which is dangerous.
  • Implement libc system() for node.js (#10547).
  • Standalone mode improvements, time (#10530, #10536), sysconf (#10535), getpagesize (#10533), _Exit (#10534)
  • Fix many closure compiler warnings (e.g. #10525).
  • Avoid unnecessary syscall proxying (#10511).

v1.39.8: 02/14/2020

  • Add LLD_REPORT_UNDEFINED option that should allow for more detailed diagnostics when symbols are undefined at link time. This currently has some limitations and is not enabled by default. For example, EM_JS symbols are reported as undefined at link time, as are __invoke_* functions.
  • wasm2js optimizations. See binaryen#2623.
  • WebGPU Compute fixes. Simple examples now work. See #10367.
  • Many DWARF debug info fixes. Emitting of DWARF is correct as far as we know, including when optimizing (a few passes are disabled for now, but almost all work). We still only generate it behind the -gforce_dwarf flag for now, though (but that should be removed soon).

v1.39.7: 02/03/2020

  • The checked-in copy of the Closure compiler was removed in favor of getting it from npm. This means that developers now need to run npm install after checking out emscripten if they want to use closure (--closure). emsdk users are not effected because emsdk runs this as a post install step (#9989).
  • Added support for specifying JSDoc minification annotations for Closure in JS library, pre and post files. See https://github.com/google/closure-compiler/wiki/Annotating-JavaScript-for-the-Closure-Compiler (#10272)
  • Add new Fibers API for context switching, that supersedes the old coroutine API that only ran on fastcomp. See #9859
  • Added new linker option -s WASM=2 which produces a dual Wasm+JS build, which falls back to using a JavaScript version if WebAssembly is not supported in target browser/shell. (#10118)
  • Added new linker option -s CLOSURE_WARNINGS=quiet|warn|error that allows aborting the build if the Closure compiler produced any warnings.

v1.39.6: 01/15/2020

  • Development has switched from the "incoming" branch to "master".
  • Added new system header <emscripten/heap.h>, which enables querying information about the current WebAssembly heap state.
  • Reduced default geometric memory overgrowth rate from a very generous 2x factor to a more memory conserving +20% factor, and capped maximum reservation to 96MB at most.
  • Added options MEMORY_GROWTH_GEOMETRIC_STEP and MEMORY_GROWTH_GEOMETRIC_CAP to allow customizing the heap growth rates.
  • Renamed MEMORY_GROWTH_STEP option to MEMORY_GROWTH_LINEAR_STEP option.
  • Added new linker option -s HTML5_SUPPORT_DEFERRING_USER_SENSITIVE_REQUESTS=0 (default enabled) to allow disabling support for deferred fullscreen mode and pointer lock requests for applications that do not need deferring support.

v1.39.5: 12/20/2019

  • Added support for streaming Wasm compilation in MINIMAL_RUNTIME (off by default)
  • All ports now install their headers into a shared directory under EM_CACHE. This should not really be a user visible change although one side effect is that once a given port is built, its headers are then universally accessible, just like the library is universally available as -l<name>.
  • Removed timestamp field from mouse, wheel, devicemotion and deviceorientation events. The presence of a timestamp on these events was slightly arbitrary, and populating this field caused a small profileable overhead that all users might not care about. It is easy to get a timestamp of an event by calling emscripten_get_now() or emscripten_performance_now() inside the event handler function of any event.
  • Add fine-grained options for specific legacy browser support, MIN_FIREFOX_VERSION, MIN_SAFARI_VERSION, MIN_IE_VERSION, MIN_EDGE_VERSION, MIN_CHROME_VERSION. The existing LEGACY_VM_SUPPORT option sets all of them to 0, that is, maximal backwards compatibility. Note that going forward, we will use these settings in more places, so if you do need very old legacy browser support, you may need to set either LEGACY_VM_SUPPORT or the fine-grained options. For more details see #9937
  • Default DISABLE_DEPRECATED_FIND_EVENT_TARGET_BEHAVIOR to 1. See #9895. With this change the old deprecated HTML5 API event target lookup behavior is disabled. There is no "Module.canvas" object, no magic "null" default handling, and DOM element 'target' parameters are taken to refer to CSS selectors, instead of referring to DOM IDs. For more information see: https://groups.google.com/forum/#!msg/emscripten-discuss/xScZ_LRIByk/_gEy67utDgAJ
  • WASI API updated from wasi_unstable to wasi_snapshot_preview1. This is mostly an implementation detail, but if you use STANDALONE_WASM it means that the output of emscripten now requires a runtime with wasi_snapshot_preview1 support.
  • SAFE_STACK has been removed, as it overlaps with STACK_OVERFLOW_CHECK. Replace SAFE_STACK=1 with STACK_OVERFLOW_CHECK=2 (note the value is 2). This also has the effect of enabling stack checking on upstream builds when ASSERTIONS are enabled (as assertions enable STACK_OVERFLOW_CHECK=2).

v1.39.4: 12/03/2019

  • Remove deprecated requestFullScreen method from library_browser.js, please use requestFullscreen (without the capital S).
  • Remove deprecated requestFullScreen and cancelFullScreen from library_glut.js
  • Remove deprecated requestFullScreen and cancelFullScreenfrom library_glfw.js
  • Fix SDL2_mixer support for ogg vorbis. See #9849
  • Various source maps fixes, see #9926 #9882 #9837 #9814

v1.39.3: 11/14/2019

v1.39.2: 11/06/2019

  • Archives with missing indexes will now have ranlib run on them automatically at link time. This avoids linker errors when using GNU ar to build archive files.
  • ERROR_ON_MISSING_LIBRARIES now also applies to internal symbols that start with emscripten_. Prior to this change such missing symbols would result in a runtime error, now they are reported at compile time.
  • Pthread blocking on the main thread will now warn in the console. If ALLOW_BLOCKING_ON_MAIN_THREAD is unset then the warning is an error.
  • Add pthread_tryjoin_np, which is a POSIX API similar to pthread_join but without blocking.
  • New function emscripten_has_asyncify().
  • Add support for pthreads in Node.js, using Node Workers. See #9745

v1.39.1: 10/30/2019

  • Only MEMFS is included by default, others (NODEFS, IDBFS, WORKERFS, PROXYFS) must be linked in explicitly, using -lnodefs.js, -lidbfs.js', -lworkerfs.js, -lproxyfs.js. See #9645

v1.39.0: 10/18/2019

  • The emsdk defaults to the upstream backend (instead of fastcomp) from this release onward (but both backends are still fully supported). See https://emscripten.org/docs/compiling/WebAssembly.html#backends
  • Add support for overriding .emscripten config variables using environment variables. Any config variable FOO can be overridden by EM_FOO in the environment.
  • -Werror now also turns warnings in the python driver code into errors.
  • Internal settings have moved from settings.js to settings_internal.js. These are settings that are for internal use only and are not set-able from the command line. If we misclassified any of these please open a bug.
  • STANDALONE_WASM mode now supports setting up argv via wasi APIs.
  • STANDALONE_WASM mode now supports running static constructors in _start.

v1.38.48: 10/11/2019

  • Add support for MAIN_THREAD_EM_ASM in wasm backend. #9560
  • Add ability to disable FETCH worker in Fastcomp backend via USE_FETCH_WORKER=0. This is useful for people who use FETCH, but don't perform any synchronous fetches on the main thread. #9567
  • Remove EMCONFIGURE_JS. Since #6269 we have set it to "2" which means never use native, always use JS.

v1.38.47: 10/02/2019

  • Add support for FETCH API in WASM backend. This doesn't support FETCH in the main thread (USE_FETCH_WORKER=0 is enforced). #9490
  • Redefine errno values to be consistent with wasi. This will let us avoid needing to convert the values back and forth as we use more wasi APIs. This is an ABI change, which should not be noticeable from user code unless you use errno defines (like EAGAIN) and keep around binaries compiled with an older version that you link against. In that case, you should rebuild them. See #9545.
  • Removed build option -s ONLY_MY_CODE as we now have much better solutions for that, like building to a wasm object file or using STANDALONE_WASM etc. (see https://github.com/emscripten-core/emscripten/wiki/WebAssembly-Standalone).
  • Emscripten now supports the config file (.emscripten) being placed in the emscripten directory rather that the current user's home directory. See #9543

v1.38.46: 09/25/2019

  • Rename libpthreads to libpthread to match its normal name on other platforms. This change should be completely internal to emscripten.
  • Remove redundant COMPILER_ENGINE and JS_ENGINE options. We only support node as the compiler engine so just use a single NODE_JS option for that.
  • Module.abort is no longer exported by default. It can be exported in the normal way using EXTRA_EXPORTED_RUNTIME_METHODS, and as with other such changes in the past, forgetting to export it will show a clear error in ASSERTIONS mode.
  • Remove EMITTING_JS flag, and replace it with STANDALONE_WASM. That flag indicates that we want the wasm to be as standalone as possible. We may still emit JS in that case, but the JS would just be a convenient way to run the wasm on the Web or in Node.js.
  • ASYNCIFY_BLACKLIST and ASYNCIFY_WHITELIST now support simple '*' wildcard matching

v1.38.45: 09/12/2019

v1.38.44: 09/11/2019

  • Remove Binaryen from the ports system. This means that emscripten will no longer automatically build Binaryen from source. Instead, either use the emsdk (binaries are provided automatically, just like for LLVM), or build it yourself and point BINARYEN_ROOT in .emscripten to it. See #9409

v1.38.43: 08/30/2019

  • noExitRuntime is no longer a property on the Module object. Use noExitRuntime instead of Module.noExitRuntime.

v1.38.42: 08/19/2019

  • Add support for address sanitizer and standalone leak sanitizer with multiple threads. (#9060, #9076)
  • Remove ERROR_ON_MISSING_LIBRARIES setting (it's always on now)
  • Remove the ability to use Python operators in flags that support KB/MB/GB/TB suffixes, e.g. TOTAL_MEMORY. This means that -s TOTAL_MEMORY=1024*1024 will no longer work. This is done because the mechanism may result in execution of arbitrary code via command line flags.

v1.38.41: 08/07/2019

  • Remove fastcomp's implementation of Asyncify. This has been deprecated for a long time, since we added Emterpreter-Async, and now we have a new Asyncify implementation in the upstream wasm backend. It is recommended to upgrade to the upstream backend and use Asyncify there if you need it. (If you do still need the older version, you can use 1.38.40.)
  • Drop ExitStatus from inheriting from Error(), as that could capture the whole global scope, preventing temporary variables at page startup from being garbage collected. (#9108)
  • __builtin_return_address now requires -s USE_OFFSET_CONVERTER=1 to work. (#9073)
  • emrun now uses HTTP/1.1 instead of HTTP/1.0.
  • callMain is no longer exported by default on Module, to allow better JS minification. You must add it to EXTRA_EXPORTED_RUNTIME_METHODS if you want to call it on Module. (In assertions builds, an error with an explanation is shown.)
  • Allow expressions with side effects as EM_ASM's arguments and prohibit non-arithmetic arguments (e.g. pointers, functions, arrays, objects). (#9054)
  • emcc on Windows now uses native newline byte sequence to get a line to print for parse error reporting. (#9088)
  • Internal API update: one can now specialize embind's (un)marshalling for a group of types via SFINAE, instead of a single type. (#9089)

v1.38.40: 07/24/2019

  • LLVM backend pthread builds no longer use external memory initialization files, replacing them with passive data segments.
  • LLVM backend now supports thread local storage via the C extension __thread and the C11/C++11 keyword thread_local. (#8976)
  • Internal API change: Move read, readAsync, readBinary, setWindowTitle from the Module object to normal JS variables. If you use those internal APIs, you must change Module.readAsync()/Module['readAsync']() to readAsync(). Note that read is also renamed to read_ (since "read" is an API call in the SpiderMonkey shell). In builds with ASSERTIONS, an error message is shown about the API change. This change allows better JS minification (the names read, readAsync etc. can be minified, and if the variables are not used they can be removed entirely). Defining these APIs on Module (which was never documented or intended, but happened to work) is also no longer allowed (but you can override read_ etc. from JS).

v1.38.39: 07/16/2019

  • Add support for address sanitizer. (#8884)
    • Currently, only supports one thread without dynamic linking.
  • Rename Bysyncify (the name used during development) to Asyncify. This keeps the name consistent with the old ASYNCIFY flag, no need for a new one, as they basically do the same thing.

v1.38.38: 07/08/2019

v1.38.37: 06/26/2019

  • Set ENV['LANG'] following the user's preferred language (HTTP Accept-Language / navigator.languages[0])
  • emscripten_run_script_string now returns C NULL instead of the string null or undefined when the result of the eval is JavaScript null or undefined.
  • Add a new system for managing system libraries. (#8780) This may require minor changes when performing certain operations:
    • When using embuilder.py to build a specific library, the name may have changed: for consistency, all library names are prefixed with lib now.
    • embuilder.py now only builds the requested library, and not its dependencies and certain system libraries that are always built. For example, running embuilder.py build libc no longer builds libcompiler_rt if it hasn't be built.
    • When using EMCC_FORCE_STDLIBS with a list of libraries, you must now use the simplified names, for example, libmalloc and libpthreads instead of libdlmalloc or libpthreads_stub. These names will link in the correct version of the library: if the build is configured to use emmalloc, libmalloc will mean libemmalloc, and if thread support is disabled, libpthreads will mean libpthreads_stub. This allows you to say libmalloc or libpthreads without worrying about which implementation is supposed to be used, and avoid duplicate symbols if you used the wrong implementation.
  • LLVM wasm backend pthreads fixes, see #8811, #8718

v1.38.36: 06/15/2019

v1.38.35: 06/13/2019

  • Include some waterfall fixes for the emsdk builds on linux regarding libtinfo.
  • NOTE: due to a CI failure, builds for mac and windows were not generated.

v1.38.34: 06/01/2019

  • Add support for undefined behavior sanitizer.
    • This allows emcc -fsanitize=undefined to work. (#8651)
    • The minimal runtime (-fsanitize-minimal-runtime) also works. (#8617)

v1.38.33: 05/23/2019

v1.38.32: SKIPPED

  • The transition from the old to the new CI occurred around here. To avoid ambiguity while both CIs were still generating builds, we just tagged a new one (1.38.33) on the new CI and skipped 1.38.32.
  • The transition also moves all builds and downloads away from the old mozilla-games infrastructure to the new chromium ones. As a result all links to mozilla-games URLs will not work (these were never documented, but could be seen from the internals of the emsdk; the new emsdk uses the proper new URLs, so you can either use the sdk normally or find the URLs from there).

v1.38.31: 04/24/2019

  • Change ino_t/off_t to 64-bits. (#8467)
  • Add port for bzip2 library (libbz2.a). (#8349)
  • Add port for libjpeg library. (#8361)
  • Enable ERROR_ON_MISSING_LIBRARIES by default (#8461)

v1.38.30: 03/21/2019

  • Remove Module.buffer which was exported by default unnecessarily. This was an undocumented internal detail, but in theory, code may have relied on it. (#8277)

v1.38.29: 03/11/2019

v1.38.28: 02/22/2019

  • Option -s EMTERPRETIFY_WHITELIST now accepts shell-style wildcards; this allows matching static functions with conflicting names that the linker distinguishes by appending a random suffix.
  • Normalize mouse wheel delta in library_browser.js. This changes the scroll amount in SDL, GLFW, and GLUT. (#7968)

v1.38.27: 02/10/2019

  • Change how EMCC_LOCAL_PORTS works, to be more usable. See #7963
  • Remove deprecated Pointer_stringify (use UTF8ToString instead). See #8011
  • Added a new option -s DISABLE_DEPRECATED_FIND_EVENT_TARGET_BEHAVIOR=1 that changes the lookup semantics of DOM elements in html5.h event handler callbacks and WebGL context creation. The new behavior is to use CSS selector strings to look up DOM elements over the old behavior, which was somewhat ad hoc constructed rules around default Emscripten uses. The old behavior will be deprecated and removed in the future. Build with -s ASSERTIONS=1 to get diagnostics messages related to this transition.
  • Breaking change with -s USE_PTHREADS=1 + -s FETCH=1: When building with -o a.html, the generated worker script is now named "a.fetch.js" according to the base name of the specified output, instead of having a fixed name "fetch-worker.js".

v1.38.26: 02/04/2019

  • Fix some pthreads proxying deadlocks. See #7865

v1.38.25: 01/18/2019

  • Move kripken/emscripten,emscripten-fastcomp,emscripten-fastcomp-clang to emscripten-core/*

v1.38.24: 01/17/2019

  • Perform JS static allocations at compile time (#7850)

v1.38.23: 01/10/2019

  • Remove BINARYEN_METHOD: no more support for interpret modes, and if you want non-wasm, use WASM=0.
  • Support specifying multiple possible ENVIRONMENTs (#7809)

v1.38.22: 01/08/2019

  • Add Regal port. See #7674
  • System libraries have been renamed to include the lib prefix. If you use EMCC_FORCE_STDLIBS or EMCC_ONLY_FORCED_STDLIBS to select system libraries you may need to add the lib prefix.
  • Rename pthread-main.js to NAME.worker.js, where NAME is the main name of your application, that is, if you emit program.js then you'll get program.worker.js (this allows more than one to exist in the same directory, etc.).
  • Dynamic linker has been taught to handle library -> library dependencies.

v1.38.21: 11/30/2018

  • fastcomp: Remove runPostSets function and replace with normal static constructor function. See #7579

v1.38.20: 11/20/2018

  • Remove SPLIT_MEMORY option.
  • Move getTempRet0/setTempRet0 to be JS library functions rather than auto-generated by fastcomp.
  • Change strptime()'s handling of the "%c" to match that of strftime(). This is a breaking change for code which depends on the old definition of "%c".

v1.38.19: 11/15/2018

v1.38.18: 11/08/2018

  • Wasm dynamic linking: Rename tableBase/memoryBase to __table_base/__memory_base (#7467)

v1.38.17: 11/07/2018

  • Minify wasm import and export names. This decreases JS and wasm size by minifying the identifiers where JS calls into wasm or vice versa, which are not minifiable by closure or other JS-only tools. This happens in -O3, -Os and above. See #7431

v1.38.16: 11/02/2018

  • Breaking change: Do not automatically set EXPORT_ALL for MAIN_MODULES or SIDE_MODULES. This means that you must explicitly export things that will be called from outside (normally, on EXPORTED_FUNCTIONS), or you can manually enable EXPORT_ALL yourself (which returns to the exact same behavior as before). This change brings us in line with more standard dynamic linking, and will match what the LLVM wasm backend will have. See #7312.
  • Invalid -s flags on the command line are now treated as errors.
  • Remove BUILD_AS_SHARED_LIBRARY setting.

v1.38.15: 10/25/2018

v1.38.14: 10/22/2018

  • Errors are now reported when functions listed in EXPORTED_FUNCTIONS are not defined. This can be disabled via ERROR_ON_UNDEFINED_SYMBOLS=0. See #7311.

v1.38.13: 10/10/2018

  • Support -s NO_X=1 as an alias for -s X=0 and vice versa, which simplifies current settings with NO_-prefixed names. See #7151.
  • Various EMULATED_FUNCTION_POINTER improvements. See #7108, #7128.
  • ERROR_ON_UNDEFINED_SYMBOLS is now the default. See #7196

v1.38.12: 09/03/2018

  • Update SDL2 to 2.0.7. See #7016.
  • Optionally build using native object files (wasm backend only). For now this is behind a new option flag: -s WASM_OBJECT_FILES=1. See #6875.

v1.38.11: 08/02/2018

  • Support for loading wasm files in the same dir as the JS file, using node.js/Web-specific techniques as applicable. See #5368 and followups.
  • Add an API for async side module compilation in wasm. See #6663.
  • Remove builtin Crunch support. See #6827.

v1.38.10: 07/23/2018

  • Change the type of size_t and friends from int to long. This may have noticeable effects if you depend on the name mangling of a function that uses size_t (like in EXPORTED_FUNCTIONS), and you must rebuild source files to bitcode (so your bitcode is in sync with the system libraries after they are rebuilt with this change). Otherwise this should not have any noticeable effects for users. See #5916.

v1.38.9: 07/22/2018

  • Fix Module.locateFile to resolve relative paths to *.wasm, *.mem and other files relatively to the main JavaScript file rather than the current working directory (see #5368).
    • Add second argument prefix to Module.locateFile function that contains the path to the JavaScript file where files are loaded from by default.
    • Remove Module.*PrefixURL APIs (use Module.locateFile instead).

v1.38.8: 07/06/2018

  • Fix a regression in 1.38.7 with binaryen no longer bundling binaryen.js (which emscripten doesn't need, that's just for handwritten JS users, but emscripten did check for its presence).

v1.38.7: 07/06/2018

  • Correctness fix for stack handling in invoke_*()s. This may add noticeable overhead to programs using C++ exceptions and (less likely) setjmp/longjmp - please report any issues. See #6666 #6702
  • Deprecate Module.ENVIRONMENT: Now that we have a compile-time option to set the environment, also having a runtime one on Module is complexity that we are better off without. When Module.ENVIRONMENT is used with ASSERTIONS it will show an error to direct users to the new option (-s ENVIRONMENT=web , or node, etc., at compile time).
  • Breaking change: Do not export print/printErr by default. Similar to other similar changes (like getValue/setValue). We now use out() and err() functions in JS to print to stdout/stderr respectively. See #6756.

v1.38.6: 06/13/2018

v1.38.5: 06/04/2018

  • Update libc++ to 6.0, bringing c++17 support (std::byte etc.)

v1.38.4: 05/29/2018

  • Fix asm.js validation regression from 1.38.2.

v1.38.3: 05/25/2018

  • Upgrade to LLVM 6.0.1.

v1.38.2: 05/25/2018

  • Add ENVIRONMENT option to specify at compile time we only need JS to support one runtime environment (e.g., just the web). When emitting HTML, set that to web so we emit web code only. #6565
  • Regression in asm.js validation due to cttz optimization #6547

v1.38.1: 05/17/2018

  • Remove special-case support for src/struct_info.compiled.json: Make it a normal cached thing like system libraries, not something checked into the source tree.
  • Breaking change: Emit WebAssembly by default. Only the default is changed - we of course still support asm.js, and will for a very long time. But changing the default makes sense as the recommended output for most use cases should be WebAssembly, given it has shipped in all major browsers and platforms and is more efficient than asm.js. Build with -s WASM=0 to disable wasm and use asm.js if you want that (or use -s LEGACY_VM_SUPPORT=1, which emits output that can run in older browsers, which includes a bunch of polyfills as well as disables wasm). (#6419)

v1.38.0: 05/09/2018

v1.37.40: 05/07/2018

  • Fix regression in 1.37.39 on -s X=@file parsing (see #6497, #6436)

v1.37.39: 05/01/2018

  • Regression: Parsing of -s X=@file broke if the file contains a newline (see #6436; fixed in 1.37.40)

v1.37.38: 04/23/2018

  • Breaking change: Simplify exception handling, disabling it by default. Previously it was disabled by default in -O1 and above and enabled in -O0, which could be confusing. You may notice this change if you need exceptions and only run in -O0 (since if you test in -O1 or above, you'd see you need to enable exceptions manually), in which case you will receive an error at runtime saying that exceptions are disabled by default and that you should build with -s DISABLE_EXCEPTION_CATCHING=0 to enable them.
  • Fix regression in 1.37.37 on configure scripts on MacOS (see #6456)

v1.37.37: 04/13/2018

  • Regression: configure scripts on MacOS may be broken (see #6456; fixed in 1.37.38)

v1.37.36: 03/13/2018

v1.37.35: 02/23/2018

  • MALLOC option, allowing picking between dlmalloc (previous allocator and still the default) and emmalloc, a new allocator which is smaller and simpler.
  • Binaryen update that should fix all known determinism bugs.

v1.37.34: 02/16/2018

  • addFunction is now supported on LLVM wasm backend, but when being used on the wasm backend, you need to provide an additional second argument, a Wasm function signature string. Each character within a signature string represents a type. The first character represents the return type of a function, and remaining characters are for parameter types.
    • 'v': void type
    • 'i': 32-bit integer type
    • 'j': 64-bit integer type (currently does not exist in JavaScript)
    • 'f': 32-bit float type
    • 'd': 64-bit float type For asm.js and asm2wasm you can provide the optional second argument, but it isn't needed. For that reason this isn't a breaking change, however, providing the second argument is recommended so that code is portable across all backends and modes.

v1.37.33: 02/02/2018

v1.37.32: 01/31/2018

v1.37.31: 01/31/2018

  • LLVM and clang updates from upstream (5.0svn, close 5.0 release).

v1.37.30: 01/31/2018

v1.37.29: 01/24/2018

v1.37.28: 01/08/2018

  • Breaking change: Don't export the ALLOC_* numeric constants by default. As with previous changes, a warning will be shown in -O0 and when ASSERTIONS are on if they are used.
  • Breaking change: Don't export FS methods by default. As with previous changes, a warning will be shown in -O0 and when ASSERTIONS are on, which will suggest either exporting the specific methods you need, or using FORCE_FILESYSTEM which will auto export all the main filesystem methods. Aside from using FS methods yourself, you may notice this change when using a file package created standalone, that is, by running the file packager directly and then loading it at run time (as opposed to telling emcc to package the files for you, in which case it would be aware of them at compile time); you should build with FORCE_FILESYSTEM to ensure filesystem support for that case.

v1.37.27: 12/24/2017

  • Breaking change: Remove the Runtime object, and move all the useful methods from it to simple top-level functions. Any usage of Runtime.func should be changed to func.

v1.37.26: 12/20/2017

  • Breaking change: Change NO_EXIT_RUNTIME to 1 by default. This means that by default we don't include code to shut down the runtime, flush stdio streams, run atexits, etc., which is better for code size. When ASSERTIONS is on, we warn at runtime if there is text buffered in the streams that should be flushed, or atexits are used.
  • Meta-DCE for JS+wasm: remove unused code between JS+wasm more aggressively. This should not break valid code, but may break code that depended on unused code being kept around (like using a function from outside the emitted JS without exporting it - only exported things are guaranteed to be kept alive through optimization).

v1.37.24: 12/13/2017

  • Breaking change: Similar to the getValue/setValue change from before (and with the same ASSERTIONS warnings to help users), do not export the following runtime methods by default: ccall, cwrap, allocate, Pointer_stringify, AsciiToString, stringToAscii, UTF8ArrayToString, UTF8ToString, stringToUTF8Array, stringToUTF8, lengthBytesUTF8, stackTrace, addOnPreRun, addOnInit, addOnPreMain, addOnExit, addOnPostRun, intArrayFromString, intArrayToString, writeStringToMemory, writeArrayToMemory, writeAsciiToMemory.

v1.37.23: 12/4/2017

  • Breaking change: Do not polyfill Math.{clz32, fround, imul, trunc} by default. A new LEGACY_VM_SUPPORT option enables support for legacy browsers. In ASSERTIONS mode, a warning is shown if a polyfill was needed, suggesting using that option.
  • Breaking change: Do not export getValue/setValue runtime methods by default. You can still use them by calling them directly in code optimized with the main file (pre-js, post-js, js libraries; if the optimizer sees they are used, it preserves them), but if you try to use them on Module then you must export them by adding them to EXTRA_EXPORTED_RUNTIME_METHODS. In -O0 or when ASSERTIONS is on, a run-time error message explains that, if they are attempted to be used incorrectly.

v1.37.17: 7/25/2017

  • Updated to libc++'s "v2" ABI, which provides better alignment for string data and other improvements. This is an ABI-incompatible change, so bitcode files from previous versions will not be compatible.

v1.37.13: 5/26/2017

  • Improved Android support for emrun.
  • Duplicate function elimination fixes (#5186)
  • Fix problem with embinding derived classes (#5193)
  • Fix CMake compiler detection when EMCC_SKIP_SANITY_CHECK=1 is used. (#5145)
  • Implemented GLFW Joystick API (#5175)
  • Fixed a bug with emcc --clear-ports command (#5248)
  • Updated Binaryen to version 33.
  • Full list of changes:

v1.37.12: 5/1/2017

v1.37.11: 5/1/2017

v1.37.10: 4/20/2017

v1.37.9: 3/23/2017

v1.37.8: 3/17/2017

v1.37.7: 3/15/2017

v1.37.6: 3/15/2017

v1.37.5: 3/13/2017

v1.37.4: 3/13/2017

  • Fixed glGetUniformLocation() to work according to spec with named uniform blocks.
  • Fixed WebAssembly Memory.grow() to work.
  • Switched to 16KB page size from earlier 64KB.
  • Optimize alBufferData() operation.
  • Fixed a resource lookup issue with multiple OpenAL audio contexts.
  • Full list of changes:

v1.37.3: 2/16/2017

v1.37.2: 1/31/2017

v1.37.1: 12/26/2016

v1.37.0: 12/23/2016

v1.36.14: 11/3/2016

  • Added support to emscripten_async_wget() for relative paths.
  • Fixed FS.mkdirTree('/') to work.
  • Updated SDL 2 port to version 12.
  • Added more missing pthreads stubs.
  • Normalize system header includes to use the preferred form #include <emscripten/foo.h> to avoid polluting header include namespaces.
  • Fixed a bug where transitioning to fullscreen could cause a stack overflow in GLFW.
  • Added new system CMake option -DEMSCRIPTEN_GENERATE_BITCODE_STATIC_LIBRARIES=ON to choose if static libraries should be LLVM bitcode instead of .a files.
  • Improved SIMD support to be more correct to the spec.
  • Updated Binaryen to version 18. (#4674)
  • Fixed dlopen with RTLD_GLOBAL parameter.
  • Full list of changes:

v1.36.13: 10/21/2016

v1.36.12: 10/20/2016

v1.36.11: 9/24/2016

v1.36.10: 9/24/2016

v1.36.9: 8/24/2016

v1.36.8: 8/20/2016

  • Fixed a memory leak in ctor_evaller.py on Windows (#4446)
  • Migrate to requiring CMake 3.4.3 as the minimum version for Emscripten CMake build integration support.
  • Fixed an issue that prevented -s INLINING_LIMIT from working (#4471)
  • Fixed a bug with Building.llvm_nm interpretation of defined symbols (#4488)
  • Add support for DISABLE_EXCEPTION_CATCHING and EXCEPTION_CATCHING_WHITELIST options for wasm.
  • Added new emprofile.py script which can be used to profile toolchain wide performance. (#4491)
  • Added new linker flag --output-eol, which specifices what kind of line endings to generate to the output files. (#4492)
  • Fixed a Windows bug where aborting execution with Ctrl-C might hang Emscripten to an infinite loop instead. (#4494)
  • Implement support for touch events to GLUT (#4493)
  • Deprecated unsafe function writeStringToMemory() from src/preamble.js. Using stringToUTF8() is recommended instead. (#4497)
  • Full list of changes:

v1.36.7: 8/8/2016

v1.36.6: 8/8/2016

  • Fixed wheelDelta for MSIE (#4316)
  • Fixed inconsistencies in fullscreen API signatures (#4310, #4318, #4379)
  • Changed the behavior of Emscripten WebGL createContext() to not forcibly set CSS style on created canvases, but let page customize the style themselves (#3406, #4194 and #4350, #4355)
  • Adjusted the reported GL_VERSION field to adapt to the OpenGL ES specifications (#4345)
  • Added support for GLES3 GL_MAJOR/MINOR_VERSION fields. (#4368)
  • Improved -s USE_PTHREADS=1 and --proxy-to-worker linker options to be mutually compatible. (#4372)
  • Improved IDBFS to not fail on Safari where IndexedDB support is spotty (#4371)
  • Improved SIMD.js support when using Closure minifier. (#4374)
  • Improved glGetString to be able to read fields from WEBGL_debug_renderer_info extension. (#4381)
  • Fixed an issue with glFramebufferTextureLayer() not working correctly.
  • Fixed a bug with std::uncaught_exception() support (#4392)
  • Implemented a multiprocess lock to access the Emscripten cache. (#3850)
  • Implemented support for the pointerlockerror event in HTML5 API (#4373)
  • Report WebGL GLSL version number in GL_SHADING_LANGUAGE_VERSION string (#4365)
  • Optimized llvm_ctpop_i32() and conversion of strings from C to JS side (#4402, #4403)
  • Added support for the OffscreenCanvas proposal, and transferring canvases to offscreen in pthreads build mode, linker flag -s OFFSCREENCANVAS_SUPPORT=0/1 (#4412)
  • Fixed an issue after updating to new LLVM version that response files passed to llvm-link must have forward slashes (#4434)
  • Fixed a memory leak in relooper in LLVM.
  • Full list of changes:

v1.36.5: 5/24/2016

v1.36.4: 5/9/2016

  • Added EM_TRUE and EM_FALSE #defines to html5.h.
  • Fixed an issue with GLFW window and framebuffer size callbacks.
  • Added support for more missing WebGL 2 texture formats (#4277)
  • Added support for source files with no extension.
  • Updated emrun.py to latest version, adds support to precompressed content and running as just a web server without launching a browser.
  • Updated experimental WebAssembly support to generate 0xb version code.
  • Automatically build Binaryen when needed.
  • Updated libc++ to SVN revision 268153. (#4288)
  • Full list of changes:

v1.36.3: 4/27/2016

v1.36.2: 4/22/2016

  • Improve support for targeting WebAssembly with Binaryen.
  • Improve support for LLVM's WebAssembly backend (EMCC_WASM_BACKEND=1 environment variable).
  • Separate out emscripten cache structure to asmjs and wasm directories.
  • Fix a bug where Emscripten would spawn too many unused python subprocesses (#4158)
  • Optimize Emscripten for large asm.js projects.
  • Added sdl2_net to Emscripten ports.
  • Updated to latest version of the SIMD polyfill (#4165)
  • Fixed an issue with missing texture formats support in GLES 3 (#4176)
  • Added a new WebAssembly linker option -s BINARYEN_IMPRECISE=1 (default=0) which mutes potential traps from WebAssembly int div/rem by zero and float-to-int conversions.
  • Added support for EXT_color_buffer_float extension.
  • Fixed behavior of SSE shift operations (#4165).
  • Fixed a bug where ctor_evaller.py (-Oz builds) would hang on Windows.
  • Fixed a bug where emscripten_set_main_loop() with EM_TIMING_SETTIMEOUT would incorrectly compute the delta times (#4200, #4208)
  • Update pthreads support to latest proposed spec version. (#4212, #4220)
  • Fixed an unresolved symbol linker error in embind (#4225)
  • Fix file_packager.py --use-preload-cache option to also work on Safari and iOS (#2977, #4253)
  • Added new file packager option --indexedDB-name to allow specifying the database name to use for the cache (#4219)
  • Added DWARF style debugging information.
  • Full list of changes:

v1.36.1: 3/8/2016

  • Fixed glfwSetWindowSizeCallback to conform to GLFW2 API.
  • Update OpenAL sources only when the browser window is visible to avoid occasional stuttering static glitches when the page tab is hidden. (#4107)
  • Implemented LLVM math intrinsics powi, trunc and floor.
  • Added support for SDL_GL_ALPHA_SIZE in GL context initialization. (#4125)
  • Added no-op stubs for several pthread functions when building without pthreads enabled (#4130)
  • Optimize glUniformfv and glVertexAttribfv functions to generate less garbage and perform much faster (#4128)
  • Added new EVAL_CTORS optimization pass which evaluates global data initializer constructors at link time, which would improve startup time and reduce code size of these ctors.
  • Implemented support for OpenAL AL_PITCH option.
  • Implemented new build options -s STACK_OVERFLOW_CHECK=0/1/2 which adds runtime stack overrun checks. 0: disabled, 1: minimal, between each frame, 2: at each explicit JS side stack allocation call to allocate().
  • Fixed an issue with -s SPLIT_MEMORY mode where an unsigned 32-bit memory access would come out as signed. (#4150)
  • Fixed asm.js validation in call handlers to llvm_powi_f*.
  • Full list of changes:

v1.36.0: 2/23/2016

v1.35.23: 2/9/2016

  • Provide $NM environment variable to point to llvm-nm when running emconfigure, which helps e.g. libjansson to build (#4036)
  • Fixed glGetString(GL_SHADING_LANGUAGE_VERSION) to return appropriate result depending on if running on WebGL1 vs WebGL2, instead of hardcoding the result (#4040)
  • Fixed a regression with CMake try_run() possibly failing, caused by the addition of CMAKE_CROSSCOMPILING_EMULATOR in v1.32.3.
  • Fixed CMake to work in the case when NODE_JS is an array containing parameters to be passed to Node.js. (#4045)
  • Fixed a memory issue that caused the Emscripten memory initializer file (.mem.js) to be unnecessarily retained in memory during runtime (#4044)
  • Added support for complex valued mul and div ops.
  • Added new option "Module.environment" which allows overriding the runtime ENVIRONMENT_IS_WEB/ENVIRONMENT_IS_WORKER/ENVIRONMENT_IS_NODE/ENVIRONMENT_IS_SHELL fields.
  • Fixed an issue with SAFE_HEAP methods in async mode (#4046)
  • Fixed WebSocket constructor to work in web worker environment (#3849)
  • Fixed a potential issue with some browsers reporting gamepad axis values outside [-1, 1] (#3602)
  • Changed libcxxabi to be linked in last, so that it does not override weakly linked methods in libcxx (#4053)
  • Implemented new JSDCE code optimization pass which removes at JS link stage dead code that is not referenced anywhere (in addition to LLVM doing this for C++ link stage).
  • Fixed a Windows issue where embedding memory initializer as a string in JS code might cause corrupted output. (#3854)
  • Fixed an issue when spaces are present in directory names in response files (#4062)
  • Fixed a build issue when using --tracing and -s ALLOW_MEMORY_GROWTH=1 simultaneously (#4064)
  • Greatly updated Emscripten support for SIMD.js intrinsics (non-SSE or NEON)
  • Fixed an issue where compiler would not generate a link error when JS library function depended on a nonexisting symbol. (#4077)
  • Removed UTF16 and UTF32 marshalling code from being exported by default.
  • Removed the -s NO_BROWSER linker option and automated the detection of when that option is needed.
  • Removed the JS implemented C++ symbol name demangler, now always depend on the libcxxabi compiled one.
  • Fixed an issue where Emscripten linker would redundantly generate missing function stubs for some functions that do exist.
  • Full list of changes:

v1.35.22: 1/13/2016

v1.35.21: 1/13/2016

v1.35.20: 1/10/2016

v1.35.19: 1/7/2016

v1.35.18: 1/7/2016

v1.35.17: 1/4/2016

v1.35.16: 1/4/2016

v1.35.15: 1/4/2016

  • Fixed an error with glClearbufferfv not working. (#3961)
  • Improved file packager code so that file:// URLs work in Chrome too (#3965)
  • Fixed issues with the --memoryprofiler UI.
  • Fixed a Windows issue when generating system libraries in cache (#3939)
  • Fixed a regression from v1.35.13 where GLES2 compilation would not work when -s USE_PTHREADS=1 was passed.
  • Added support for WebIDL arrays as input parameters to WebIDL binder.
  • Updated build support when using the LLVM wasm backend.
  • Added new linker option --threadprofiler which generates a threads dashboard on the generated page for threads status overview. (#3971)
  • Improved backwards compatibility of building on GCC 4.3 - 4.6.
  • Fixed an asm.js validation issue when building against updated SIMD.js specification. (#3986)
  • Improved Rust support.
  • Full list of changes:

v1.35.14: 12/15/2015

v1.35.13: 12/15/2015

v1.35.12: 11/28/2015

v1.35.11: 11/27/2015

v1.35.10: 11/25/2015

  • Integration with Binaryen.
  • Add a performance warning when multiple FS.syncfs() calls are in flight simultaneously.
  • Correctly pass GLFW_REPEAT when sending key press repeats.
  • Improved filesystem performance when building in multithreaded mode (#3923)
  • Improve error detection when data file fails to load.
  • Clarified that -s NO_DYNAMIC_EXECUTION=1 and -s RELOCATABLE=1 build modes are mutually exclusive.
  • Added new build option -s NO_DYNAMIC_EXECUTION=2 which demotes eval() errors to warnings at runtime, useful for iterating fixes in a codebase for multiple eval()s (#3930)
  • Added support to Module.locateFile(filename) to locate the pthread-main.js file (#3500)
  • Changed -s USE_PTHREADS=2 and -s PRECISE_F32=2 to imply --separate-asm instead of requiring it, to be backwards compatible (#3829, #3933)
  • Fixed bad codegen for some 64-bit atomics (#3892, #3936)
  • When emitting NaN canonicalization warning, also print the location in code where it occurs.
  • Full list of changes:

v1.35.9: 11/12/2015

v1.35.8: 11/10/2015

v1.35.7: 11/4/2015

v1.35.6: 11/4/2015

  • This tag was created for technical purposes, and has no changes compared to v1.35.6.

v1.35.5: 11/4/2015

  • Removed Content-Length and Connection: close headers in POST requests.
  • Migrate to using the native C++11-implemented optimizer by default.
  • Fixed call to glDrawBuffers(0, *); (#3890)
  • Fixed lazy file system to work with closure (#3842)
  • Fixed gzip compression with lazy file system (#3837)
  • Added no-op gracefully failing stubs for process spawn functions (#3819)
  • Clarified error message that memory growth is not supported with shared modules (#3893)
  • Initial work on wasm support in optimizer
  • Full list of changes:

v1.35.4: 10/26/2015

v1.35.3: 10/26/2015

v1.35.2: 10/20/2015

v1.35.1: 10/20/2015

v1.35.0: 10/19/2015

v1.34.12: 10/13/2015

  • Added new experimental build option -s SPLIT_MEMORY=1, which splits up the Emscripten HEAP to multiple smaller slabs.
  • Added SDL2_ttf to Emscripten ports.
  • Added support for building GLES3 code to target WebGL 2. (#3757, #3782)
  • Fixed certain glUniform*() functions to work properly when called in conjunction with -s USE_PTHREADS=1.
  • Fixed support for -l, -L and -I command line parameters to accept a space between the path, i.e. "-l SDL". (#3777)
  • Fixed SSE2 support in optimized builds.
  • Changed the default behavior of warning when absolute paths are passed to -I to be silent. To enable the absolute paths warning, pass "-Wwarn-absolute-paths" flag to emcc.
  • Added new linker option -s ABORTING_MALLOC=0 that can be used to make malloc() return 0 on failed allocation (Current default is to abort execution of the page on OOM) (#3822)
  • Removed the default behavior of automatically decoding all preloaded assets on page startup (#3785)
  • Full list of changes:

v1.34.11: 9/29/2015

v1.34.10: 9/25/2015

v1.34.9: 9/18/2015

v1.34.8: 9/9/2015

  • Fixed a race condition at worker startup (#3741)
  • Update emrun to latest, which improves unit test run automation with emrun.
  • Added support for LZ4 compressing file packages, used with the -s LZ4=1 linker flag. (#3754)
  • Fixed noisy build warning on "unexpected number of arguments in call to strtold" (#3760)
  • Added new linker flag --separate-asm that splits the asm.js module and the handwritten JS functions to separate files.
  • Full list of changes:

v1.34.7: 9/5/2015

v1.34.6: 8/20/2015

v1.34.5: 8/18/2015

v1.34.4: 8/4/2015

  • Add special handling support for /dev/null as an input file (#3552)
  • Added basic printf support in NO_FILESYSTEM mode (#3627)
  • Update WebVR support to the latest specification, and add support for retrieving device names
  • Improved --proxy-to-worker build mode with proxying (#3568, #3623)
  • Generalized EXPORT_FS_METHODS to EXPORT_RUNTIME_METHODS
  • Added node externs for closure
  • Fixed a memory allocation bug in pthreads code (#3636)
  • Cleaned up some debug assertion messages behind #ifdef ASSERTIONS (#3639)
  • Fixed umask syscall (#3637)
  • Fixed double alignment issue with formatStrind and emscripten_log (#3647)
  • Added new EXTRA_EXPORTED_RUNTIME_METHODS build option
  • Updated emrun to latest version
  • Full list of changes:

v1.34.3: 7/15/2015

v1.34.2: 7/14/2015

v1.34.1: 6/18/2015

v1.34.0: 6/16/2015

v1.33.2: 6/9/2015

v1.33.1: 6/3/2015

v1.33.0: 5/29/2015

v1.32.4: 5/16/2015

v1.32.3: 5/15/2015

v1.32.2: 5/8/2015

v1.32.1: 5/2/2015

v1.32.0: 4/28/2015

v1.31.3: 4/22/2015

v1.31.2: 4/20/2015

v1.31.1: 4/17/2015

v1.31.0: 4/14/2015

v1.30.6: 4/14/2015

  • Removed support for the deprecated jcache functionality (#3313).
  • Added support to emscripten_GetProcAddress() to fetch symbols with the ANGLE suffix (#3304, #3315).
  • Added immintrin.h header file to include all SSE support.
  • Added an async option to ccall (#3307).
  • Stopped from using 0 as a valid source ID for OpenAL (#3303).
  • When project has disabled exception catching, build an exceptions-disabled version of libcxx.
  • Split libcxx into two parts to optimize code size for projects that only need small amount of libcxx (#2545, #3308).
  • Avoid fprintf usage in emscripten_GetProcAddress() to allow using it with -s NO_FILESYSTEM=1 (#3327).
  • Removed old deprecated functionalities USE_TYPED_ARRAYS, FHEAP, GC emulation and non-asmjs-emscripten ABI.
  • Don't refer to prefixed GL extensions when creating a GL context (#3324).
  • Removed support code for x86_fp80 type (#3341).
  • Optimize EM_ASM() calls even more (#2596).
  • Full list of changes:

v1.30.5: 4/7/2015

v1.30.4: 4/3/2015

v1.30.3: 4/3/2015

v1.30.2: 4/1/2015

v1.30.1: 3/24/2015

v1.30.0: 3/24/2015

  • Fixed a bug where html5.h API would not remove event handlers on request.
  • Fixed a regression issue that broke building on Windows when attempting to invoke tools/gen_struct_info.py.
  • Improved memory growth feature to better handle growing to large memory sizes between 1GB and 2GB (#3253).
  • Fixed issues with emrun with terminating target browser process, managing lingering sockets and command line quote handling.
  • Fixed a bug where unsigned integer return values in embind could be returned as signed (#3249).
  • Improved handling of lost GL contexts.
  • Changed malloc to be fallible (return null on failure) when memory growth is enabled (#3253).
  • Fixed a bug with WebIDL not being able to handle enums (#3258).
  • Updated POINTER_MASKING feature to behave as a boolean rather than a mask (#3240).
  • Improved "emcmake cmake" on Windows to automatically remove from path any entries that contain sh.exe in them, which is not supported by CMake.
  • Fixed an issue with symlink handling in readlink (#3277).
  • Updated SDL2 port to version 6.
  • Removed the obsolete FAST_MEMORY build option.
  • Added reciprocalApproximation and reciprocalSqrtApproximation SIMD intrinsics.
  • Full list of changes:

v1.29.12: 3/15/2015

v1.29.11: 3/11/2015

v1.29.10: 2/19/2015

  • Add a warning message when generating code that has a very large number of variables, which optimization flags could remove.
  • Improve support for SIMD casts and special loads.
  • Fix the process return code when using EMCONFIGURE_JS=1.
  • Improved the error message in abort().
  • Fix main loop handling during emterpreter sync save/load.
  • Handle emscripten_async_call and friends during sleep, by pausing all safeSet*() operations.
  • Add support for Google WTF when building with --tracing.
  • Improve emterpreter stability with fuzzing.
  • Add an option to load the memory initializer file from a typed array (#3187)
  • Remove linker warning message when linking to -lm, since Emscripten includes musl that implements the math libraries built-in.
  • Add support for SDL_WM_SetCaption(), which calls to Module['setWindowTitle'], or if not present, sets the web page title. (#3192)
  • Full list of changes:

v1.29.9: 2/9/2015

  • Documented FORCE_ALIGNED_MEMORY to be no longer supported.
  • Fixes issues with native optimizer handling of "if () else {}" statements. (#3129)
  • Improved cross-browser support for EMSCRIPTEN_FULLSCREEN_FILTERING_NEAREST. (#3165)
  • Added new linker option --profiling-funcs, which generates output that is otherwise minified, except that function names are kept intact, for use in profilers and getting descriptive call stacks.
  • The Module object is no longer written in global scope. (#3167)
  • Added new emscripten_idb_* API. (#3169)
  • Added new function emscripten_wget_data().
  • Add support for GL_RED with GLES3/WebGL2. (#3176)
  • Added basic WebVR support. (#3177)
  • Full list of changes:

v1.29.8: 1/31/2015

v1.29.7: 1/28/2015

v1.29.6: 1/23/2015

v1.29.5: 1/23/2015

  • Enable compiling source files with the extension ".c++".
  • Enable versioning of the emscripten ports so that older Emscripten versions can keep using older versions of the ports (#3144)
  • Added a whitelist option to emterpreter, a linker flag of form -s EMTERPRETIFY_WHITELIST=["symbol1","symbol2"]. (#3129)
  • Improved emscripten_get_pointerlock_status() to always fill the output structure even when pointer lock is not supported.
  • Added an environment variable EMCC_NO_OPT_SORT=0/1 option to configure whether the generated output should have the functions sorted by length, useful for debugging.
  • Added new tool tools/merge_pair.py which allows bisecting differences between two output files to find discrepancies.
  • Improved parsing in cashew.
  • Improved output message from emconfigure and emmake when inputs are unexpected.
  • Added built-in asm handler for LLVM fabs operation.
  • Full list of changes:

v1.29.4: 1/21/2015

  • Added new C <-> JS string marshalling functions asciiToString(), stringToAscii(), UTF8ToString(), stringToUTF8() that can be used to copy strings across the JS and C boundaries. (#2363)
  • Added new functions lengthBytesUTF8(), lengthBytesUTF16() and lengthBytesUTF32() to allow computing the byte lengths of strings in different encodings. (#2363)
  • Upgraded SDL2 port to version 4.
  • Add support for saving the emterpreter stack when there are functions returning a value on the stack (#3129)
  • Notice async state in emterpreter trampolines (#3129)
  • Optimize SDL1 pixel copying to the screen.
  • Fixed an issue with emterpreter parsing. (#3141)
  • Fixed an issue with native optimizer and -s PPRECISE_F32=1.
  • Full list of changes:

v1.29.3: 1/16/2015

v1.29.2: 1/16/2015

v1.29.1: 1/7/2015

v1.29.0: 1/7/2015

v1.28.3: 1/4/2015

v1.28.2: 12/17/2014

v1.28.1: 12/15/2014

v1.28.0: 12/12/2014

v1.27.2: 12/10/2014

v1.27.1: 11/20/2014

v1.27.0: 11/20/2014

v1.26.1: 11/7/2014

v1.26.0: 10/29/2014

v1.25.2: 10/16/2014

  • Fixed a bug in tmpfile() function not allocating the mode argument correctly.
  • Fixed a bug with handling empty files in IDBFS (#2845)
  • Added an implementation of the utimes() function (#2845)
  • Added experimental WebGL 2.0 support with the linker flag -s USE_WEBGL2=1. (#2873)
  • Fixed a UnboundTypeError occurring in embind (#2875)
  • Fixed an error "IndexSizeError: Index or size is negative or greater than the allowed amount" being thrown by Emscripten SDL 1.2 surface blit code. (#2879)
  • Fixed a JS minifier issue that generated "x--y from x - -y" (#2869)
  • Added a new emcc command line flag "--cache " to control the location of the Emscripten cache directory (#2816)
  • Implemented SDL_ConvertSurface() and added support for SDL_SRCALPHA in SDL_SetAlpha (#2871)
  • Fixed issues with the GL library handling of invalid input values.
  • Optimized SDL copyIndexedColorData function (#2890)
  • Implemented GLES3 emulation for glMapBufferRange() for upcoming WebGL 2 support, using the -s FULL_ES3=1 linker option.
  • Fixed a bug where setting up and cancelling the main loop multiple times would stack up the main loop to be called too frequently (#2839)
  • Introduced a new API emscripten_set_main_loop_timing() for managing the Emscripten main loop calling frequency (#2839)
  • Added new optimization flags SDL.discardOnLock and SDL.opaqueFrontBuffer to Emscripten SDL 1.2 SDL_LockSurface() and SDL_UnlockSurface() (#2870)
  • Fixed a bug with glfwGetProcAddress().
  • Added option to customize GLOBAL_BASE (the starting address of global variables in the Emscripten HEAP).
  • Added the ability to register mouseover and mouseout events from the HTML5 API.
  • Improved experimental SIMD support.
  • Full list of changes:

v1.25.1: 10/1/2014

v1.25.0: 9/30/2014

v1.24.1: 9/27/2014

  • Fixed issues with the tmpnam and tmpfile functions (#2797, 2798)
  • Fixed CMake package find code to not search any system directories, because Emscripten is a cross-compiler.
  • Improved support for the proposed solution for heap resizing.
  • Fixed an issue where one could not run a main loop without having first a GL context created when -s FULL_ES2 or -s LEGACY_GL_EMULATION were set.
  • For compatibility, Emscripten will no longer warn about missing library files for -lGL, -lGLU and -lglut libraries, since Emscripten provides the implementation for these without having to explicitly link to anything.
  • Added support for readonly (const) attributes and automatically call Pointer_stringify on DOMStrings in WebIDL.
  • Improved SIMD support for the experimental Ecmascript SIMD spec.
  • Added support for GLFW 3.0.
  • Added new Emscripten HTML 5 functions emscripten_set_mouseenter_callback() and emscripten_set_mouseleave_callback().
  • Emscripten now recognizes an environment variable EMCC_JSOPT_BLACKLIST=a,b,c,d which can be used to force-disable Emscripten to skip running specific JS optimization passes. This is intended as a debugging aid to help zoom in on JS optimizer bugs when compiling with -O1 and greater. (#2819)
  • Fixed a bug where Module['TOTAL_STACK'] was ignored (#2837).
  • Improved SIMD support for the experimental Ecmascript SIMD spec. Preliminary asm.js validation.
  • Full list of changes:

v1.24.0: 9/16/2014

v1.23.5: 9/12/2014

  • Added new functions emscripten_get_device_pixel_ratio(), emscripten_set_canvas_css_size() and emscripten_get_canvas_css_size() which allow handling High DPI options from C code.
  • Fixed bugs with timzone-related functions in the JS-implemented C standard library.
  • Implemented clock_gettime(CLOCK_MONOTONIC) and added a new function emscripten_get_now_is_monotonic() to query whether the JS-provided timer is monotonic or not.
  • Fixed an issue where the user could not pass --llvm-opts=xxx when also specifying --llvm-lto=2.
  • Renamed the linker option -profiling to --profiling for consistency. The old form is still supported.
  • Formalized the set of valid characters to be used in files passed to the file_packager.py (#2765).
  • Implemented SDL function SDL_BlitScaled.
  • Fixed a bug with right modifier keys in SDL.
  • Full list of changes:

v1.23.4: 9/7/2014

v1.23.3: 9/7/2014

  • Removed the scons-tools SCons build system as unused.
  • Fixed an issue where applications could not handle WebGL context creation failures gracefully.
  • Fixed a bug where the stringToC function in ccall/cwrap might not allocate enough space to hold unicode strings.
  • Removed CMake from attempting to link to library -ldl when building projects, by unsetting CMAKE_DL_LIBS.
  • Fixed a bug where write_sockaddr might return undefined data in its output structure.
  • Added a new experimental -s POINTER_MASKING=1 linker option that might help JS VMs to optimize asm.js code.
  • Added first version of a memory tracing API to profile memory usage in Emscripten applications.
  • Added functions glob and globfree from musl regex library.
  • Improved SIMD support for the experimental Ecmascript SIMD spec.
  • Full list of changes:

v1.23.2: 9/2/2014

  • Adjusted the process and group ids reported by the stub library functions to be closer to native unix values.
  • Set stack to be aligned to 16 bytes. (#2721)
  • Fixed a compiler error "unresolved symbol: __cxa_decrement_exception_refcount" (#2715)
  • Added a new warning message that instructs that building .so, .dll and .dylib files is not actually supported, and is faked for compatibility reasons for existing build chains. (#2562)
  • Fixed problems with SDL mouse scrolling (#2643)
  • Implemented OpenAL function alSourceRewind.
  • Removed several old header files from the Emscripten repository that had been included for emulation purposes (zlib.h, png.h, tiff.h, tiffio.h), but their implementation is not included.
  • Work around an issue in d8 with binary file reading that broke e.g. printf when running in d8. (#2731)
  • Rigidified the semantics of Module.preRun and Module.postRun: These must always be JS arrays, single functions are not allowed (#2729)
  • Improved compiler warning diagnostics when generating output that will not validate as asm.js (#2737)
  • Updated to latest emrun version to enable support for passing arguments with hyphens to the program. (#2742)
  • Added Bessel math functions of the first kind (j0, j1, jn) from musl.
  • Improved SIMD support for the experimental Ecmascript SIMD spec.
  • Full list of changes:

v1.23.1: 8/26/2014

  • Add support for the Chrome variant of the Gamepad API.
  • Updates to SIMD.js support.
  • Implemented glutSetCursor function.
  • Added new link-time options -s NO_FILESYSTEM=1 and -s NO_BROWSER=1 to enable reducing output file sizes when those functionalities are not necessary.
  • Added a new option --closure 2 to allow running closure even on the asm.js output.
  • Fixed a regression bug that broke the use of emscripten_set_socket_error_callback() in emscripten.h
  • Removed the support for old discontinued Mozilla Audio Data API in src/library_sdl.js.
  • Removed the support for using Web Audio ScriptProcessorNode to stream audio.
  • Improved SDL audio streaming by using the main rAF() callback instead of a separate setTimeout() callback to schedule the audio data.
  • Deprecated compiling without typed arrays support.
  • Migrated to using musl PRNG functions. Fixes reported bugs about the quality of randomness (#2341)
  • Improved SIMD support for the experimental Ecmascript SIMD spec.
  • Full list of changes:

v1.23.0: 8/21/2014

v1.22.2: 8/19/2014

  • Adds stack overflow checks when building with the link flag -s ASSERTIONS=1.
  • Fix an issue where EM_ASM was not usable with closure when closure removed the Module object (#2639)
  • The locale "POSIX" is now recognized (#2636)
  • Fixed a problem with embind on IE11.
  • Added OpenAL functions alSource3i, alListener3f, alGetEnumValue and alSpeedOfSound and also recognize ALC_MAX_AUXILIARY_SENDS.
  • Fixed an issue where emcc would create .o files in the current directory when compiling multiple code files simultaneously (#2644)
  • The -s PROXY_TO_WORKER1= option now looks for a GET option "?noProxy" in the page URL to select at startup time whether proxying should be on or off.
  • Added new functions emscripten_yield, emscripten_coroutine_create and emscripten_coroutine_next which implement coroutines when building with the -s ASYNCIFY=1 option.
  • Optimized the size of intermediate generated .o files by omitting LLVM debug info from them when not needed. (#2657)
  • Fixed WebSocket connection URLs to allow a port number in them, e.g. "server:port/addr" (2610)
  • Added support for void* to the WebIDL binder, via the identifier VoidPtr.
  • Optimize emcc to not copy bitcode files around redundantly.
  • Fix stat() to correctly return ENOTDIR when expected (#2669).
  • Fixed issues with nested exception catching (#1714).
  • Increased the minimum size of the Emscripten HEAP to 64k instead of a previous 4k.
  • The {{{ cDefine('name') }}} macros now raise a compile-time error if the define name is not found, instead of hiding the error message inside the compiled output (#2672)
  • Fixed an issue where --emrun parameter was not compatible with the -s PROXY_TO_WORKER=1 option.
  • Improved WebGL support when compiling with the PROXY_TO_WORKER=1 option.
  • Fixed a regression issue with the handling of running dtors of classes that use virtual inheritance. (#2682)
  • Added an option Module.locateFilePackage() as a means to customize where data files are found in relative to the running page (#2680). NOTE: This parameter was later renamed to Module.locateFile() instead in release 1.24.0.
  • Fixed a bug where OpenAL sources would not properly delete.
  • Fixed a bug with upstream libc++ on std::map, std::multimap and std::unordered_map self-assignment (http://llvm.org/bugs/show_bug.cgi?id=18735)
  • Allow using asm volatile("": : :"memory") as a compile-time reordering barrier (#2647)
  • Full list of changes:

v1.22.1: 8/7/2014

  • Added support for prefixing functions with '$' in JS libraries, in order to cause them not be prefixed with '_' when compiling.
  • Improved WebIDL compiler to support enums.
  • Fixed a bug with emscripten_force_exit() that would throw an exception (#2629).
  • Fixed setlocale() when setting a bad locale. (#2630)
  • Fixed a compiler miscompilation bug when optimizing loops. (#2626)
  • Fixed an issue with rethrowing an exception (#2627)
  • Fixed a bug where malloc()ing from JS code would leak memory if the C/C++ side does not use malloc() (#2621)
  • Removed an unnecessary assert() in glReadPixels, and improved it to support more texture pixel types.
  • Fixed a bug with std::locale accepting unknown locale names (#2636)
  • Added support for WebIDL binder to work with Closure (#2620)
  • Added no-op SDL IMG_Quit() and TTF_Quit() symbols.
  • Migrated to building libcxx and libcxxapi with -Oz optimization flags.
  • Full list of changes:

v1.22.0: 8/5/2014

v1.21.10: 7/29/2014

  • Fixed a Windows-specific issue where the generated output files might contain line endings of form \r\r\n. This caused browser debuggers to get confused with line numbers. (#2133)
  • Improved the node.js workaround introduced in v1.21.8.
  • Implemented new HTML5 API for direct WebGL context creation, emscripten_webgl_*().
  • Fixed a bug when loading in node.js and loaded by another module (#2586)
  • Full list of changes:

v1.21.9: 7/28/2014

v1.21.8: 7/28/2014

v1.21.7: 7/25/2014

  • Added new environment varaible EMCC_ONLY_FORCED_STDLIBS which can be used to restrict to only linking to the chosen set of Emscripten-provided libraries. (See also EMCC_FORCE_STDLIBS)
  • Adjusted argv[0] and environment variables USER, HOME, LANG and _ to report a more convenient set of default values. (#2565)
  • Fixed an issue where the application could not use environ without also referring to getenv() (#2557)
  • Fixed an issue with IDBFS running in web workers.
  • Print out an error if IDBFS is used without IDB support.
  • Fixed calling Runtime.getFuncWrapper() when -s ALIASING_FUNCTION_POINTERS=1 (#2010)
  • Fixed an issue where deleting files during directory iteration would produce incorrect iteration results (#2528)
  • Fixed support for strftime with %z and %Z (#2570)
  • Fixed a bug with truncate() throwing an exception (#2572)
  • Improved the linker to generate warning messages if user specifies -s X=Y linker flags that do not exist (#2579)
  • Fixed an issue with creating read-only files (#2573)
  • Added first implementation for the ASYNCIFY option, which splits up synchronous blocking loops to asynchronous execution. For more information on this approach, see https://github.com/emscripten-core/emscripten/wiki/Asyncify
  • Full list of changes:

v1.21.6: 7/22/2014

  • Separated OpenAL AL and ALC errors to properly separate fields.
  • When using EGL to initialize a GL context, initialize a stencil buffer to the context as well, since proper EGL context choosing is not yet implemented.
  • Added new linker flag -s DEMANGLE_SUPPORT to choose whether to compile the application with libcxxabi-provided demangling support ___cxa_demangle().
  • Fixed a problem where calling stat() on a nonexisting file in the runtime VFS would result in an exception being thrown. (#2552)
  • When using the -v flag, no longer retain intermediate compilation files. To preserve the intermediate files, set the EMCC_DEBUG=1 environment variable. (#2538)
  • Added a new HTML setting Module.memoryInitializerPrefixURL which specifies a prefix for where the memory initializer file .mem.js should be loaded from (#2542)
  • Implemented eglReleaseThread to work according to spec.
  • Implemented a new function emscripten_force_exit() which immediately shuts down the C runtime.
  • Fixed a bug with exception handling that resulted in an error unresolved symbol: _ZTISt13bad_exception (#2560)
  • Full list of changes:

v1.21.5: 7/21/2014

  • Added support for glDrawBuffers with the WEBGL_draw_buffers extension.
  • Added stub implementation for eglReleaseThread.
  • Fixed a bug where passing -E to emcc used the system include headers instead of the built-in ones. (#2534)
  • Fixed the stacktrace() function to work on MSIE as well.
  • Removed the zlib.h header file from system include directory, since Emscripten does not provide an implementation of zlib built-in.
  • Added support for __cxa_bad_typeid (#2547)
  • Fixed an internal compiler crash with a certain pattern involving optimized builds and int64_t (#2539)
  • Fixed an issue with -s EXCEPTION_CATCHING_WHITELIST handling where an extension that was a substring of another might get erroneously handled.
  • Full list of changes:

v1.21.4: 7/17/2014

  • Implemented the getsockopt() function.
  • Added new event callback functions emscripten_set_socket_xx_callback() that allow listening to WebSocket events in an asynchronous manner.
  • Greatly improved CMake support, now various forms of configure-time test builds are supported, and the default extension is set to ".js"
  • Prohibit the virtual filesystem from creating files with name '.' or '..' at runtime.
  • Have runtime mkdir() function call normalize the path to be created before creation.
  • Fixed an issue with omitting the third paramter in cwrap() call (#2511).
  • Fixed an issue where mouse event handling would throw an exception if the page did not contain a canvas object.
  • Fixed a GL initialization problem when user has extended Array with custom functions (#2514)
  • Added new compiler defines EMSCRIPTEN_major, EMSCRIPTEN_minor and EMSCRIPTEN_tiny which communicate the compiler version major.minor.tiny to compiled applications (#2343)
  • Fixed a bug where emrun did not properly capture the exit code when exit runtime via not calling exit().
  • Fixed an error message when symlinkin invalid filenams at runtime.
  • Fixed a bug in EGL context creation that parsed the input context creation parameters with wrong terminator.
  • Improved ffdb.py to be smarter when to attempt port forwarding to connect to a FFOS device DevTools port.
  • Implemented strsignal() function (#2532)
  • Full list of changes:

v1.21.3: 7/10/2014

  • Added implementations for SDL function SDL_AudioQuit and SDL_VideoQuit.
  • Fix an issue with the optimizeShifts optimization enabled in previous version.
  • Fixed the -s RELOOPER command line parameter to work.
  • Fixed a bug where building the system libc migt result in a compiler deadlock on Windows.
  • Removed emcc from trying to link in .dll files as static libraries on Windows.
  • Added support for GL_HALF_FLOAT_OES.
  • Fixed a bug where emcmake did not work on Windows.
  • Use multithreaded compilation to build libc.
  • Fixed an issue where the GL interop library could throw an exception in an error condition, instead of raising a GL error.
  • Full list of changes:

v1.21.2: 7/5/2014

  • Improved the checks that detect that code is run only while the runtime is initialized.
  • The memory initializer file (.mem.js) is now emitted by default when compiling with at least -O2 optimization level.
  • Fixed a performance issue where built-in math functions (Math.sqrt, etc.) took a slightly slower path (#2484).
  • Added support for the ffs libc function.
  • Re-enabled optimizeShifts optimization when not compiling for asm.js (#2481)
  • Full list of changes:

v1.21.1: 7/3/2014

v1.21.0: 7/2/2014

  • Enable memory init files (.mem) by default in optimized builds (-O2+), as if --memory-init-file 1 is specified. This makes the default behavior on optimized builds emit smaller and faster-to-load code, but does require that you ship both a .js and a .mem file (if you prefer not to, can use --memory-init-file 1 ).
  • Implemented new SDL 1.2 functions SDL_GetRGB, SDL_GetRGBA and SDL_putenv.
  • Added support for /dev/random, /dev/urandom and C++11 std::random_device, which will use cryptographically secure random api if available. (#2447)
  • Added support for CMake find_path() directive.
  • Added support for std::unique_ptr in embind.
  • Improved Windows support for ffdb.py.
  • Implemented the clip_rect structure for created SDL surfaces.
  • Fixed a regression with SDL touch events (#2466)
  • Added support for C++11 std::thread::hardware_concurrency which backs to navigator.hardwareConcurrency. See http://wiki.whatwg.org/wiki/Navigator_HW_Concurrency (#2456)
  • Optimized embind code generation with constexprs.
  • Enabled the use of Runtime.add&removeFunction when closure minification is active (#2446)
  • Implemented support for accessing WebGL when building via the proxy to worker architecture.
  • Full list of changes:

v1.20.0: 6/13/2014

  • Optimize in-memory virtual filesystem performance when serialized to an IndexedDB.
  • Fixed memcpy regression with ta0 and ta1 modes.
  • Fixed an issue with line numbers being messed up when generating source maps (#2410)
  • Fixed an ffdb logging bug that could cause it to drop messages if they were being received too fast. Added support getting memory and system descriptions with ffdb.
  • Added a new extension to SDL "emscripten_SDL_SetEventHandler()" which enabled application to perform SDL event handling inside a JS event handler to overcome browser security restrictions. (#2417)
  • Full list of changes:

v1.19.2: 6/9/2014

v1.19.1: 6/3/2014

v1.19.0: 5/29/2014

  • Added an error message to signal that linkable modules are not supported in fastcomp.
  • Fixed a miscompilation issue that resulted in an error "SyntaxError: invalid increment operand" and a statement +(+0) being generated (#2314)
  • Make optimized compiler output smaller by running the shell code through uglify when not using closure.
  • Fixed a crash in SDL audio loading code introduced in v1.18.3
  • Fixed an issue where glTex(Sub)Image2D might throw an exception on error, instead of setting glGetError().
  • Added new typedefs emscripten_align1_short, emscripten_align{1/2}_int, emscripten_align{1/2}_float and emscripten_align{1/2/4}_double to ease signaling the compiler that unaligned data is present. (#2378)
  • Fixed an embind issue with refcount tracking on smart pointers.
  • Full list of changes:

v1.18.4: 5/27/2014

v1.18.3: 5/21/2014

v1.18.2: 5/19/2014

v1.18.1: 5/12/2014

  • Fixed an issue where the mouse wheel scroll did not work with SDL.
  • Fixed an issue with emscripten_async_wget, which undesirably expected that the string pointer passed to it stayed alive for the duration of the operation (#2349)
  • Emscripten now issues a warning message when the EXPORTED_FUNCTIONS list contains invalid symbol names (#2338)
  • Full list of changes:

v1.18.0: 5/10/2014

v1.17.0: 5/6/2014

  • Enabled asm.js compilation and -s PRECISE_F32 support when using embind.
  • Improved relooper to emit switches in many-entried blocks.
  • Fixed a GLFW bug where mouse wheel direction was reversed.
  • Fixed glfwGetKey to work even when no callback is registered with glfwGetKeyCallback (#1320)
  • Added a new tool 'webidl_binder' that generates C <-> JS interop code from WebIDL descriptions.
  • Fix emscripten compilation to work on pages that don't contain a HTML canvas.
  • Added a new error message to default shell when an uncaught exception is thrown.
  • Improved error diagnostics reported by -s SAFE_HEAP=1.
  • Added support for registering callbacks hook to VFS file open, write, move, close and delete.
  • Added embind support to std::basic_string
  • By default, the C runtime will no longer exit after returning from main() when safeSetTimeout() or safeSetInterval() is used.
  • Fixed an issue with sscanf formatting (#2322)
  • Fixed an issue where precompiled headers were given a wrong output filename (#2320)
  • Enabled registerizeHarder optimization pass to work when outlining is enabled.
  • Fixed an issue with strptime month handling (#2324)
  • Added an initial implementation of a new tool 'ffdb' which can be used to operate a Firefox OS phone from the command line.
  • Fixed a compiler crash on assertion failure '!contains(BranchesOut, Target)' (emscripten-fastcomp #32)
  • Added a new ABI to Clang that targets Emscripten specifically. Stop aligning member functions to save some space in the function table array.
  • Full list of changes:

v1.16.0: 4/16/2014

v1.15.1: 4/15/2014

  • Added support for SDL2 touch api.
  • Added new user-controllable emdind-related define #define EMSCRIPTEN_HAS_UNBOUND_TYPE_NAMES, which allows optimizing embind for minimal size when std::type_info is not needed.
  • Fixed issues with CMake support where CMAKE_AR and CMAKE_RANLIB were not accessible from CMakeLists.txt files.
  • Full list of changes:

v1.15.0: 4/11/2014

v1.14.1: 4/8/2014

  • Added new command line utility 'emcmake', which can be used to call emconfigure for cmake.
  • Added a new emcc command line parameter '--valid-abspath', which allows selectively suppressing warning messages that occur when using absolute path names in include and link directories.
  • Added a new emcc linker command line parameter '--emit-symbol-map', which will save a map file between minified global names and the original function names.
  • Fixed an issue with --default-object-ext not always working properly.
  • Added optimizations to eliminate redundant loop variables and redundant self-assignments.
  • Migrated several libc functions to use compiled code from musl instead of handwritten JS implementations.
  • Improved embind support.
  • Renamed the EM_ASM_() macro to the form EM_ASM_ARGS().
  • Fixed mouse button ordering issue in glfw.
  • Fixed an issue when creating a path name that ends in a slash (#2258, #2263)
  • Full list of changes:

v1.14.0: 3/25/2014

v1.13.2: 3/15/2014

v1.13.1: 3/10/2014

v1.13.0: 3/3/2014

  • Fixed the deprecated source mapping syntax warning.
  • Fixed a buffer overflow issue in emscripten_get_callstack (#2171).
  • Added support for -Os (optimize for size) and -Oz (aggressively optimize for size) arguments to emcc.
  • Fixed a typo that broko the call signature of glCompressedTexSubImage2D() function (#2173).
  • Added new browser fullscreen resize logic that always retains aspect ratio and adds support for IE11.
  • Improve debug messaging with bad function pointer calls when -s ASSERTIONS=2 is set.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.12.3...1.13.0

v1.12.3: 2/27/2014

v1.12.2: 2/25/2014

v1.12.1: 2/25/2014

  • TURNED ON FASTCOMP BY DEFAULT. This means that you will need to migrate to fastcomp-clang build. Either use an Emscripten SDK distribution, or to build manually, see http://kripken.github.io/emscripten-site/docs/building_from_source/LLVM-Backend.html for info.
  • Migrate to requiring Clang 3.3 instead of Clang 3.2. The fastcomp-clang repository by Emscripten is based on Clang 3.3.
  • Deprecated old Emscripten libgc implementation.
  • asm.js will now be always enabled, even in -O0 builds in fastcomp.
  • Remove support for -s RUNTIME_TYPE_INFO, which is unsupported in fastcomp.
  • Added a new "powered by Emscripten" logo.
  • Updated default shell.html graphical layout.
  • Added new macro EM_ASM_, which allows sending values to JS without returning anything.
  • Deprecated the jcache compiler option. It should not be needed anymore.
  • Added support for fetching callstack column information in Firefox 30 in emscripten_get_callstack.
  • Fix issues with missing exceptions-related symbols in fastcomp.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.12.0...1.12.1

v1.12.0: 2/22/2014

  • Improved the runtime abort error message when calling an invalid function pointer if compiled with -s ASSERTIONS=1 and 2. This allows the developer to better deduce errors with bad function pointers or function pointers casted and invoked via a wrong signature.
  • Added a new api function emscripten_set_main_loop_arg, which allows passing a userData pointer that will be carried via the function call, useful for object-oriented encapsulation purposes (#2114).
  • Fixed CMake MinSizeRel configuration type to actually optimize for minimal size with -Os.
  • Added support for GLES2 VAO extension OES_vertex_array_object for browsers that support it.
  • Fix issues with emscripten/html5.f when compiled with the SAFE_HEAP option.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.11.1...1.12.0

v1.11.1: 2/19/2014

v1.11.0: 2/14/2014

  • Implemented some new SDL library functions.
  • Renamed standard file descriptors to have handles 0, 1 and 2 rather than 1, 2 and 3 to coincide with unix numbering.
  • Improved embind support with smart pointers and mixins.
  • Improved the registerization -O3 optimization pass around switch-case constructs.
  • Upper-case files with suffix .C are now also recognized (#2109).
  • Fixed an issue with glGetTexParameter (#2112).
  • Improved exceptions support in fastcomp.
  • Added new linker option -s NO_EXIT_RUNTIME=1, which can be used to set a default value for the Module["noExitRuntime"] parameter at compile-time.
  • Improved SDL audio buffer queueing when the sample rate matches the native web audio graph sample rate.
  • Added an optimization that removes redundant Math.frounds in -O3.
  • Improved the default shell.html file.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.10.4...1.11.0

v1.10.4: 2/10/2014

v1.10.3: 2/9/2014

v1.10.2: 2/7/2014

  • Added basic FS unmount support.
  • Improved screen orientation lock API to return a success code.
  • Added PRECISE_F32 support to fastcomp.
  • Fixed issues in fastcomp related to special floating point literal serialization.
  • Improved SDL audio buffer queueing.
  • Added new link-time option -s WARN_UNALIGNED=1 to fastcomp to report compiler warnings about generated unaligned memory accesses, which can hurt performance.
  • Optimized libc strcmp and memcmp with the implementations from musl libc.
  • Optimized libc memcpy and memset to back to native code for large buffer sizes.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.10.1...1.10.2

v1.10.1: 1/31/2014

v1.10.0: 1/29/2014

  • Improved C++ exception handling.
  • Improved OpenAL library support.
  • Fixed an issue where loading side modules could try to allocate from sealed heap (#2060).
  • Fixed safe heap issues (2068).
  • Added new EM_ASM variants that return a value but do not receive any inputs (#2070).
  • Add support for simultaneously using setjmp and C++ exceptions in fastcomp.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.9.5...1.10.0

v1.9.5: 1/25/2014

v1.9.4: 1/24/2014

  • Add support for Ninja and Eclipse+Ninja builds with Emscripten+CMake.
  • Fixed regressions with GL emulation.
  • Added support for #if !X in .js library preprocessor.
  • Make the syntax EM_ASM("code"); not silently fail. Note that the proper form is EM_ASM(code); without double-quotes.
  • Optimize generated code size by minifying loop labels as well.
  • Revised the -O3 optimization level to mean "safe, but very slow optimizations on top of -O2", instead of the old meaning "unsafe optimizations". Using -O3 will now only do safe optimizations, but can be very slow compared to -O2.
  • Implemented a new registerization optimization pass that does extra variable elimination in -O3 and later to reduce the number of local variables in functions.
  • Implemented a new emscripten/html5.h interface that exposes common HTML5 APIs directly to C code without having to handwrite JS wrappers.
  • Improved error messages reported on user-written .js libraries containing syntax errors (#2033).
  • Fixed glBufferData() function call signature with null data pointer.
  • Added new option Module['filePackagePrefixURL'] that allows customizing the URL where the VFS package is loaded from.
  • Implemented glGetTexEnviv and glGetTexEnvfv in GL emulation mode.
  • Optimized the size of large memory initializer sections.
  • Fixed issues with the safe heap compilation option.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.9.3...1.9.4

v1.9.3: 1/17/2014

v1.9.2: 1/16/2014

v1.9.1: 1/16/2014

v1.9.0: 1/16/2014

v1.8.14: 1/15/2014

v1.8.13: 1/15/2014

v1.8.12: 1/15/2014

v1.8.11: 1/15/2014

v1.8.10: 1/14/2014

v1.8.9: 1/14/2014

v1.8.8: 1/14/2014

v1.8.7: 1/13/2014

v1.8.6: 1/8/2014

v1.8.5: 1/7/2014

v1.8.4: 1/6/2014

v1.8.3: 1/5/2014

v1.8.2: 1/4/2014

v1.8.1: 1/3/2014

  • Added support for WebGL hardware instancing extension.
  • Improved fastcomp native LLVM backend support.
  • Added support for #include filename.js to JS libraries.
  • Deprecated --compression emcc command line parameter that manually compressed output JS files, due to performance issues. Instead, it is best to rely on the web server to serve compressed JS files.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.8.0...1.8.1

v1.8.0: 12/28/2013

v1.7.9: 12/27/2013

  • Added new command line parameter --em-config that allows specifying a custom location for the .emscripten configuration file.
  • Reintroduced relaxed asm.js heap sizes, which no longer need to be power of 2, but a multiple of 16MB is sufficient.
  • Added emrun command line tool that allows launching .html pages from command line on desktop and Android as if they were native applications. See https://groups.google.com/forum/#!topic/emscripten-discuss/t2juu3q1H8E . Adds --emrun compiler link flag.
  • Began initial work on the "fastcomp" compiler toolchain, a rewrite of the previous JS LLVM AST parsing and codegen via a native LLVM backend.
  • Added --exclude-file command line flag to emcc and a matching --exclude command line flag to file packager, which allows specifying files and directories that should be excluded while packaging a VFS data blob.
  • Improved GLES2 and EGL support libraries to be more spec-conformant.
  • Optimized legacy GL emulation code path. Added new GL_FFP_ONLY optimization path to fixed function pipeline emulation.
  • Added new core functions emscripten_log() and emscripten_get_callstack() that allow printing out log messages with demangled and source-mapped callstack information.
  • Improved BSD Sockets support. Implemented getprotobyname() for BSD Sockets library.
  • Fixed issues with simd support.
  • Various bugfixes: #1573, #1846, #1886, #1908, #1918, #1930, #1931, #1942, #1948, ..
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.7.8...1.7.9

v1.7.8: 11/19/2013

v1.7.7: 11/16/2013

v1.7.6: 11/15/2013

  • Added regex implementation from musl libc.
  • The command line parameter -s DEAD_FUNCTIONS=[] can now be used to explicitly kill functions coming from built-in library_xx.js.
  • Improved EGL support and GLES2 spec conformance.
  • Reverted -s TOTAL_MEMORY=x to require pow2 values, instead of the relaxed 'multiples of 16MB'. This is because the relaxed rule is released only in Firefox 26 which is currently in Beta and ships on the week of December 10th (currently in Beta). As of writing, current stable Firefox 25 does not yet support these.
  • Adjusted the default linker behavior to warn about all missing symbols, instead of silently ignoring them. Use -s WARN_ON_UNDEFINED_SYMBOLS=0 to suppress these warnings if necessary.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.7.5...1.7.6

v1.7.5: 11/13/2013

v1.7.4: 11/12/2013

v1.7.3: 11/12/2013

v1.7.2: 11/9/2013

  • The compiler now always generates a .js file that contains the generated source code even when compiling to a .html file.
  • Implemented depth+stencil buffer choosing behavior in GLUT, SDL and GLFW.
  • Fixed memory leaks generated by glGetString and eglGetString.
  • Greatly optimized startup times when virtual filesystems with a large amount of files in them.
  • Added some support for SIMD generated by LLVM.
  • Fixed some mappings with SDL keyboard codes.
  • Added a new command line parameter --no-heap-copy to compiler and file packager that can be used to optimize VFS memory usage at startup.
  • Updated libcxx to revision 194185, 2013-11-07.
  • Improvements to various library support.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.7.1...1.7.2

v1.7.1: 10/24/2013

v1.7.0: 10/23/2013

  • Adds mouse wheel events support in GLUT library.
  • Adds support for a new link parameter -s CASE_INSENSITIVE_VFS=1 to enable Emscripten virtual filesystem to search files ignoring case.
  • Numerous optimizations in both compilation and runtime stages.
  • Remove unnecessary whitespace, compact postSets function, and other optimizations in compilation output to save on generated file size.
  • Fixes float parsing from negative zero.
  • Removes the -s EMIT_GENERATED_FUNCTIONS link parameter as unneeded.
  • Fixes an issue where updating subranges of GL uniform arrays was not possible.
  • asm.js heap size (-s TOTAL_MEMORY=x) no longer needs to be a power of 2. As a relaxed rule, choosing any multiple of 16MB is now possible.
  • O1 optimization no longer runs the 'simplifyExpressions' optimization pass. This is to improve build iteration times when using -O1. Use -O2 to run that pass.
  • EM_ASM() can now be used even when compiling to asm.js.
  • All currently specified non-debugging-related WebGL 1 extensions are now enabled by default on startup, no need to ctx.getExtension() manually to enable them.
  • Improve readability of uncaught JavaScript exceptions that are thrown all the way up to the web console by printing out the stack trace of where the throw occurred.
  • Fix an issue when renaming a directory to a subdirectory.
  • Several compiler stability fixes.
  • Adds a JavaScript implementation of cxa_demangle function for demangling call stack traces at runtime for easier debugging.
  • GL context MSAA antialising is now DISABLED by default, to make the GL behavior consistent with desktop usage.
  • Added support to SDL, GLUT and GLFW libraries to specify MSAA on/off at startup.
  • Implemented glColor4ubv in GL emulation mode.
  • Fix an issue with LLVM keyword attribute ((constructor)) (#1155).
  • Fix an issue with va_args and -s UNALIGNED_MEMORY=1 (#1705).
  • Add initial support code for LLVM SIMD constructs and a JavaScript SIMD polyfill implementation from https://github.com/johnmccutchan/ecmascript_simd/ .
  • Fixed support for node.js native filesystem API NODEFS on Windows.
  • Optimize application startup times of Emscripten-compiled programs by enabling the virtual filesystem XHR and asm.js compilation to proceed in parallel when opening a page.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.6.4...1.7.0

v1.6.4: 9/30/2013

  • Implements a new preprocessor tool for preparsing C struct definitions (#1554), useful for Emscripten support library implementors.
  • Fix parsing issue with sscanf (#1668).
  • Improved the responsiveness of compiler print output on Windows.
  • Improved compilation times at link stage.
  • Added support for new "NODEFS" filesystem that directly accesses files on the native filesystem. Only usable with node.js when compiling to JS.
  • Added support for new IDBFS filesystem for accessing files in IndexedDB storage (#1601.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.6.3...1.6.4

v1.6.3: 9/26/2013

v1.6.2: 9/25/2013

  • Added support for dprintf() function (#1250).
  • Fixes several compiler stability issues (#1637, #1166, #1661, #1651 and more).
  • Enables support for WEBGL_depth_texture.
  • Adds support for new link flag -s GL_ASSERTIONS=1 which can be used to add extra validation layer to the Emscripten GL library to catch code issues.
  • Adds support to Web Audio API in SDL audio backend so that SDL audio now works in Chrome and new Opera as well.
  • Fixes an alpha blending issue with SDL_SetAlpha.
  • Implemented locale-related code in C library.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.6.1...1.6.2

v1.6.1: 9/22/2013

v1.6.0: 9/21/2013

v1.5.9: 9/15/2013

v1.5.8: 9/14/2013

v1.5.7: 8/30/2013

  • The script tag in default shell.html is now marked 'async', which enables loading the JS script code asynchronously in Firefox without making the main thread unresponsive.
  • Implemented new utility function emscripten_get_canvas_size() which returns the current Module element size in pixels.
  • Optimize code size in compiled side modules.
  • Optimize startup memory usage by avoiding unnecessary copying of VFS data at startup.
  • Add support for SDL_WM_ToggleFullScreen().
  • Add support for emscripten_get_now() when running in SpiderMonkey shell.
  • Added new environment variable EM_BUILD_VERBOSE=0,1,2,3 to set an extra compiler output verbosity level for debugging.
  • Added better support for dlopen() to simulate dynamic library loading in JavaScript.
  • Improved support for BSD sockets and networking.
  • Added new SOCKFS filesystem, which reads files via a network connection.
  • Avoid issues with long command line limitations in CMake toolchain by using response files.
  • Fix issues with client-side vertex data rendering in GL emulation mode.
  • Improved precision of clock_gettime().
  • Improve function outlining support.
  • Added support for using NMake generator with CMake toolchain.
  • Improved support for flexible arrays in structs (#1602).
  • Added ability to marshal UTF16 and UTF32 strings between C++ <-> JS code.
  • Added a new commandline tool validate_asms.py to help automating asm.js validation testing.
  • Improved stability with inline asm() syntax.
  • Updated libc headers to new version.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.5.6...1.5.7

v1.5.6: 8/17/2013

  • Improved BSD sockets support.
  • Added touch events support to GLUT library.
  • Added new --js-opts=0/1 command line option to control whether JS optimizer is run or not.
  • Improved OpenAL support.
  • Added new command line tool tools/find_bigvars.py which can be used on an output file to detect large functions and needs for outlining.
  • Merged link flags -s FORCE_GL_EMULATION and -s DISABLE_GL_EMULATION to a single opt-in flag -s LEGACY_GL_EMULATION=0/1 to control whether GL emulation is active.
  • Improved SDL input support.
  • Several stability-related compiler fixes.
  • Fixed source mapping generation support on Windows.
  • Added back the EMSCRIPTEN_KEEPALIVE attribute qualifier to help prevent inlining and to retain symbols in output without dead code elimination occurring.
  • Fix issues when marshalling UTF8 strings between C<->JS.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.5.5...1.5.6

v1.5.5: 8/9/2013

v1.5.4: 8/9/2013

  • Fixed multiple issues with C stdlib support.
  • Fix audio buffer queueing issues with OpenAL.
  • Improved BSD sockets support.
  • Added a new compile+link time command line option -Wno-warn-absolute-paths to hide the emscripten compiler warning when absolute paths are passed into the compiler.
  • Added new link flag -s STB_IMAGE=0/1 and integrate it to SDL image loading to enable synchronous image loading support with SDL.
  • Several improvements on function outlining support.
  • Fix issues with GLES2 interop support.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.5.3...1.5.4

v1.5.3: 6/28/2013

v1.5.2: 6/27/2013

v1.5.1: 6/22/2013

v1.5.0: 6/17/2013

v1.4.9: 6/8/2013

v1.4.8: 6/6/2013

v1.4.7: 6/2/2013

v1.4.6: 6/2/2013

v1.4.5: 6/1/2013

v1.4.4: 6/1/2013

  • Add support for symlinks in source files.
  • Fix various issues with SDL.
  • Added -s FORCE_ALIGNED_MEMORY=0/1 link time flag to control whether all loads and stores are assumed to be aligned.
  • Fix file packager to work with closure.
  • Major improvements to embind support, and optimizations.
  • Improve GL emulation.
  • Optimize VFS usage.
  • Allow emscripten to compile .m and .mm files.
  • Added new syntax --preload-file src@dst to file packager command line to allow placing source files to custom destinations in the FS.
  • Full list of changes: https://github.com/emscripten-core/emscripten/compare/1.4.3...1.4.4

v1.4.3: 5/8/2013

v1.4.2: 5/3/2013

v1.4.1: 4/28/2013

v1.3.8: 4/29/2013

v1.3.7: 4/24/2013

v1.3.6: 4/2/2013

v1.3.5: 3/25/2013

v1.3.4: 3/24/2013

v1.3.3: 3/23/2013

v1.3.2: 3/22/2013

v1.3.1: 3/19/2013

v1.3.0: 3/11/2013

v1.2.9: 3/7/2013

v1.2.8: 3/6/2013

v1.2.7: 3/6/2013

v1.2.6: 3/5/2013

v1.2.5: 3/5/2013

v1.2.4: 2/2/2013

v1.2.3: 1/9/2013

v1.2.2: 1/8/2013

v1.2.1: 1/8/2013

v1.2.0: 1/1/2013

v1.1.0: 12/12/2012

v1.0.1a: 11/11/2012

v1.0.1: 11/11/2012

  • First commit that introduced versioning to the Emscripten compiler.